Idempotência

Repita requisições de escrita com segurança.

Envie Idempotency-Key em chamadas de criação e captura para que retentativas de rede não dupliquem operações financeiras.

Use chaves estáveis de negócio

Prefira chaves derivadas do seu pedido ou operação, como order_123_create e order_123_capture.

Criar charge com idempotencia

curl -X POST https://bunne.com.br/api/v1/charges \  -H "Authorization: Bearer sk_test_xxx" \  -H "Idempotency-Key: order_123_attempt_1" \  -H "Content-Type: application/json" \  -d '{"amount":10990,"currency":"BRL","payment_method":"PIX"}'

Comportamento

Campo	Tipo	Descrição
`same key + same body`	replay	Retorna a resposta original bem-sucedida.
`same key + different body`	error	Retorna idempotency_key_conflict.
`missing key`	allowed	A requisição funciona, mas retentativas podem duplicar escritas.

Resposta de conflito

{  "error": {    "type": "idempotency_error",    "code": "idempotency_key_conflict",    "message": "Invalid idempotency key usage.",    "request_id": "req_xxx"  }}