PortuguêsComeçandoInício rápido

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

Pré-condições

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.

Webhook é melhor-esforço

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