Início rápido
Em três passos você emite sua primeira cobrança PIX.
1. Gere uma API key
No painel da INFI, vá em Dispositivos / API keys e clique em Criar nova chave. O segredo completo é mostrado uma única vez. Guarde em local seguro (cofre de segredos, variável de ambiente).
A criação exige KYC aprovado e e-mail verificado. Se algum estiver pendente, finalize o cadastro antes de continuar.
2. Crie uma cobrança
Endpoint: POST https://api.internationalfinance.com.br/v1/pix. Use Authorization: Bearer <SUA_API_KEY>.
curl -X POST https://api.internationalfinance.com.br/v1/pix \
-H "Authorization: Bearer $INFI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amountCents": 1000,
"externalRef": "pedido-123",
"expiresInDays": 2,
"customer": {
"name": "Maria Silva",
"email": "maria@exemplo.com",
"document": { "number": "12345678901", "type": "cpf" }
}
}'Resposta 201:
{
"transactionId": "Q4t9aV...",
"status": "pending",
"pixPayload": "00020126580014BR.GOV.BCB.PIX...",
"expiresAt": 1715000000,
"amountCents": 1000
}Apresente pixPayload ao pagador como copia-e-cola ou gere o QR Code dele no seu lado.
3. Receba a confirmação
Cadastre uma URL HTTPS no painel em Webhook. Quando o status mudar (paid, failed, cancelled…), a INFI faz POST no seu endpoint com a assinatura HMAC. Veja Configurando o webhook.
A INFI envia uma única tentativa do webhook (timeout de 8s). Se sua aplicação cair ou demorar a responder, o evento pode ser perdido — implemente um fallback consultando GET /v1/transactions/:id para os status finais.
Próximos passos
- Autenticação — formato da chave e revogação.
- Referência de cobranças — todos os campos.
- Erros — formato e mensagens conhecidas.