EspañolEmpezandoInicio rápido

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).

Precondiciones

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.

El webhook es mejor-esfuerzo

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