Pagar via QR Code

Inicia um pagamento Pix a partir de um QR Code (estático ou dinâmico) lido previamente.

POST/pix/payments/qrcode

Parâmetros

ParâmetroTipoDescrição
account_id*uuidConta de origem.
qr_code*stringConteúdo BR Code (Copia e Cola).
amountintegerValor em centavos. Obrigatório para QR estático sem valor.
descriptionstringTexto livre exibido ao recebedor.

Exemplo de requisição

curl -X POST https://api.pix.nixfin.com.br/pix/payments/qrcode \
  -H "Authorization: Bearer $BS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
       "account_id": "acc_9f2b3c",
       "qr_code": "00020126580014BR.GOV.BCB.PIX...",
       "amount": 5000
     }'

Exemplo de resposta

{
  "id": "pix_p1q2r3",
  "status": "processing",
  "end_to_end_id": "E98765432202604231400P1Q2R3S4T5U",
  "amount": 5000,
  "created_at": "2026-04-23T14:00:00Z"
}

Toda chamada deve incluir o header Idempotency-Key (UUID) para evitar débito duplicado.