1. INICIO
Novus Pagamentos
  • INICIO
    • Autenticação e Segurança
    • 🔁 Idempotência
  • INVOICES
    • Webhooks - PIX-IN
    • Split de pagamentos
    • Criação de Invoices
      POST
    • Buscar Invoices
      GET
    • Listar Invoices
      GET
  • PAYOUT
    • Webhooks - PIX-OUT
    • Criar Payout
      POST
    • Buscar Payouts
      GET
    • Listar payouts
      GET
    • Recibo payout
      GET
  • BALANCE
    • Obter balanço da conta
      GET
  1. INICIO

🔁 Idempotência

🔁 Idempotência#

Evite duplicações acidentais de payouts e invoices causadas por timeouts, retentativas ou falhas de rede.

🔑 Cabeçalho Idempotency-Key#

Envie um UUID v4 único no cabeçalho Idempotency-Key ao criar payouts ou invoices. Se a mesma chave for enviada novamente, a resposta original será retornada sem re-executar a operação.
EndpointSuporte
POST /api/v2/payout✅
POST /api/v2/invoices✅
💡 O cabeçalho é opcional. Sem ele, a requisição é processada normalmente.

Exemplos de Requisição#

cURL#

JavaScript#

Python#


✅ Boas Práticas#

1.
Gere um novo UUID para cada operação distinta
2.
Reutilize o mesmo UUID ao retentar a mesma operação
3.
Nunca reutilize uma chave para operações diferentes
4.
Armazene a chave junto ao seu registro local para poder retentar com segurança
Página anterior
Autenticação e Segurança
Próxima página
Webhooks - PIX-IN
Built with