Desenvolvedores
Documentação da API
Tudo o que você precisa para integrar a KyvoPay: autenticação, pagamentos, webhooks e mais. Valores sempre em centavos.
Exemplo · criar cobrança Pix
POST /v1/payments
Authorization: Bearer sk_test_...
Idempotency-Key: pedido-1001
{
"amount": 10000,
"payment_method": "pix",
"customer": { "name": "João Silva" }
}Primeiros passos
Crie a conta, aprove o sandbox e gere sua primeira chave de teste.
Ambientes
Sandbox e produção são totalmente isolados, com chaves separadas.
Autenticação
Use sua chave secreta no header Authorization: Bearer sk_...
Idempotência
Envie Idempotency-Key para garantir que uma cobrança execute uma única vez.
Pagamentos Pix
Crie cobranças com valor em centavos e acompanhe o status.
Webhooks
Receba eventos assinados com HMAC e com retentativas automáticas.
Erros
Respostas de erro seguem um formato único com code, message e request_id.
Saques
Solicite saques e acompanhe o status até a conclusão.
A referência interativa (Swagger/OpenAPI) é servida pela API em /docs quando ela está rodando.