Referência da API
Nossa API RESTful foi desenhada para desenvolvedores. Utilize chaves de API padronizadas para autenticar requisições estruturadas em JSON e receber respostas rápidas e previsíveis.
Autenticação (Basic Auth)
Todas as requisições devem incluir o header de autorização passando sua `Secret Key`. Nunca exponha sua chave secreta no frontend.
// Header de requisição
Authorization: Basic c2tfdGVzdF9rb25kZXNpZ246
Authorization: Basic c2tfdGVzdF9rb25kZXNpZ246
POST
/v1/transactions/pix
Gera um QR Code dinâmico e a string "Copia e Cola" instantaneamente.
Request Payload
{
"amount": 15000, // R$ 150,00
"customer": {
"name": "Cliente Teste",
"document": "00000000000"
},
"postback_url": "https://seu-site.com/webhook"
}
"amount": 15000, // R$ 150,00
"customer": {
"name": "Cliente Teste",
"document": "00000000000"
},
"postback_url": "https://seu-site.com/webhook"
}
Response (200 OK)
{
"id": "txn_9832104",
"status": "waiting_payment",
"pix": {
"qr_code_url": "https://pay.kondesign/qr/...",
"copy_paste": "00020126580014br.gov.bcb.pix..."
}
}
"id": "txn_9832104",
"status": "waiting_payment",
"pix": {
"qr_code_url": "https://pay.kondesign/qr/...",
"copy_paste": "00020126580014br.gov.bcb.pix..."
}
}