Recarga PIX

POST /api/v1/administrative/topups

Recargas administrativas são exclusivamente programáticas e disponíveis para contas pré-pagas. Envie uma Idempotency-Key única em cada intenção de recarga.

curl -X POST https://app.fontedata.com/api/v1/administrative/topups \
  -H "X-API-Key: fd_live_sua_chave" \
  -H "Idempotency-Key: recarga-2026-08-21-001" \
  -H "Content-Type: application/json" \
  -d '{"amount":"100.00","method":"pix"}'

Uma criação nova responde 201. Repetir a mesma chave e valor devolve a mesma recarga com 200; se o provedor ainda estiver gerando o PIX, responde 202 e Retry-After: 1. Reutilizar a chave com outro valor responde 409.

Enquanto pendente, a resposta inclui pix.copy_and_paste, pix.qr_code_url e pix.expires_at. Os estados públicos são pending, credited, expired e failed; estados intermediários do provedor não fazem parte do contrato.

Consultar uma recarga

curl https://app.fontedata.com/api/v1/administrative/topups/po_123 \
  -H "X-API-Key: fd_live_sua_chave"

Para obter a imagem PNG, use GET /api/v1/administrative/topups/{id}/qr.png com a mesma chave.