Cobranças

Cobranças são a base dos fluxos PIX e cartão autenticados pelo lojista.

Endpoint principal

POST /v1/charges cria uma cobrança PIX ou cartão. O corpo usa amount_cents, payment_method e um objeto customer.

curl -X POST https://api.sandbox.mupag.com.br/v1/charges \
  -H "Authorization: Bearer sk_test_your_server_key" \
  -H "Idempotency-Key: 11111111-2222-3333-4444-555555555555" \
  -H "Content-Type: application/json" \
  -d '{"amount_cents":1590,"payment_method":"pix","customer":{"name":"Ana Silva","email":"ana@example.com","tax_id":"12345678909"}}'

Resposta esperada

Para PIX você recebe charge_id, status, pix_emv_code, pix_qr_code_base64 e expires_at. Para cartão, acompanhe o status final por webhook e consulta.

Operação segura

• Gere Idempotency-Key por tentativa lógica.
• Use o mesmo customer_id quando o comprador já existe.
• Não finalize entrega ou acesso só com a resposta síncrona; espere o evento apropriado.