Help/Support
Frequently asked questions
Quick answers about keys, environments, webhooks, retries and duplicated payments.
Can I call the API from a browser?
No. API keys are server credentials. Call KyvoPay from your backend and expose only the minimum data your frontend needs.
How do I know a Pix payment was completed?
Validate the payment webhook on your server. Do not rely on a customer action, browser redirect or client-side polling alone.
What should I retry?
Retry timeouts, connection failures, 429 and temporary 5xx responses with backoff. Reuse the same idempotency key for the same write operation.
Why did I receive the same webhook twice?
Webhook delivery is at least once. Store a unique event id and make handlers idempotent.
Can sandbox data be used in production?
No. Credentials and resources are isolated between environments.