Chaves de Idempotência

Evite cobranças duplicadas ou transações redundantes causadas por falhas temporárias de rede ou timeouts.

O Cabeçalho Idempotency-Key

A API EDPay suporta o cabeçalho Idempotency-Key em todas as operações de mutação (especialmente POST /v1/payments e POST /v1/payment-links).

Ao enviar uma chave de idempotência exclusiva (exemplo: UUID v4), a API armazena em cache o resultado da primeira operação durante 24 horas. Qualquer pedido subsequente com a mesma chave devolverá exactamente a resposta gravada sem reexecutar o débito.

Exemplo de Pedido com Idempotency-Key

POST /v1/payments HTTP/1.1
Host: api-pay.edutecka.com
X-EDPay-Public-Key: pk_live_49f81a7b...
X-EDPay-Private-Key: sk_live_82c13e4a...
Idempotency-Key: req_c0a8010a-8bf3-4621-a7ee-5488cba88091
Content-Type: application/json