Cobranças PIX — /api/v1/charges - NavePay

POST /api/v1/charges

Cria cobrança PIX (QR dinâmico). Contrato de corpo alinhado à API v2 e ao escopo da chave. Corpo (campos principais):

amount (obrigatório)
payer.name, payer.document (obrigatórios)
payer.email, external_id, postbackUrl, payerQuestion, split (opcionais)

Se external_id for omitido, a plataforma gera um id (chg-...).

curl -s -X POST "https://seu-dominio.com/api/v1/charges" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 49.90,
    "external_id": "pedido-123",
    "payer": {
      "name": "Cliente",
      "document": "00000000191",
      "email": "cliente@email.com"
    }
  }'

GET /api/v1/charges

Query opcional: per_page, status.

GET /api/v1/charges/

charge = UUID público da transação ou external_id.