Perguntas frequentes
Chaves, ambientes, webhooks e pagamento em duplicidade.
Perdi minha chave de API. Como recupero?
Não dá: o segredo aparece uma única vez. Crie uma nova, publique com ela e revogue a antiga. Ver Chaves de API.
Posso usar a chave no front-end?
Não. A chave dá acesso total à conta pela API. Ela vive no seu servidor; o navegador fala com o seu backend, e o seu backend fala com a KyvoPay.
Meu webhook não recebe nada. Por onde começo?
Confira, nesta ordem: a URL cadastrada é https e pública, o endpoint responde 200, e o ambiente do webhook é o mesmo da chave que criou a cobrança. Ver Troubleshooting.
O cliente pagou duas vezes. E agora?
Reembolse a cobrança duplicada e trate a causa: cobrança criada sem idempotency_key costuma estar por trás. Ver Idempotência.
Dá para testar sem dinheiro real?
Sim, é exatamente para isso que existe o sandbox, com uma chave de teste. Ver Sandbox e produção.
Qual o valor mínimo de uma cobrança?
O valor mínimo de uma cobrança PIX é R$ 1,00 (100 centavos). O limite máximo pode variar conforme a configuração da conta e da rota ativa.
A KyvoPay é um banco?
Não. É uma plataforma de pagamentos e tecnologia financeira; a liquidação acontece pela infraestrutura das instituições parceiras.