Criar Cobrança

Gere cobranças instantâneas via PIX, obtenha QR Codes e monitore o ciclo de vida dos pagamentos. Esta rota cria uma nova cobrança na NomadPay.

POST/charges

Descrição

Gera uma cobrança PIX instantânea e retorna os dados do QR Code para pagamento (payload Copia e Cola) juntamente com o ID da transação.

Parâmetros (Body)

• amount number Obrigatório O valor da cobrança em reais (ex: 100.50).

• description string Obrigatório Descrição interna para a cobrança (ex: "Pedido #1234").

• expiration number Opcional Tempo de expiração do PIX em segundos (padrão: 3600).

Requisição

curl -X POST https://paynomad-backend.nomadpay.workers.dev/charges \
  -H "Authorization: Bearer <SEU_CLIENT_SECRET>" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.50,
    "description": "Pedido #1234",
    "expiration": 3600
  }'

Resposta (200 OK)

{
  "id": "chg_xxxxxxx",
  "amount": 100.50,
  "description": "Pedido #1234",
  "status": "PENDING",
  "pix_code": "000201010211...",
  "created_at": "2024-01-01T12:00:00Z"
}