Inicio rápido
En tres pasos emites tu primer cobro PIX.
1. Genera una API key
En el panel de INFI, ve a Dispositivos / API keys y haz clic en Crear nueva clave. El secreto completo se muestra una sola vez. Guárdalo en un lugar seguro (gestor de secretos, variable de entorno).
La creación exige KYC aprobado y correo verificado. Si alguno está pendiente, finaliza el alta antes de continuar.
2. Crea un cobro
Endpoint: POST https://api.internationalfinance.com.br/v1/pix. Usa Authorization: Bearer <TU_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@ejemplo.com",
"document": { "number": "12345678901", "type": "cpf" }
}
}'Respuesta 201:
{
"transactionId": "Q4t9aV...",
"status": "pending",
"pixPayload": "00020126580014BR.GOV.BCB.PIX...",
"expiresAt": 1715000000,
"amountCents": 1000
}Muestra pixPayload al pagador como copiar-y-pegar o genera el QR Code en tu lado.
3. Recibe la confirmación
Registra una URL HTTPS en el panel, en Webhook. Cuando el estado cambia (paid, failed, cancelled…), INFI hace POST a tu endpoint con la firma HMAC. Ver Configurar el webhook.
INFI envía un único intento del webhook (timeout de 8 s). Si tu aplicación cae o tarda en responder, el evento puede perderse — implementa un fallback consultando GET /v1/transactions/:id para los estados finales.
Próximos pasos
- Autenticación — formato de la clave y revocación.
- Referencia de cobros — todos los campos.
- Errores — formato y mensajes conocidos.