Toda criação que move dinheiro exige o cabeçalho Idempotency-Key. Use um valor único por operação no seu sistema, como o ID do pedido.
  • Mesma chave e mesmo corpo: a API devolve o resultado guardado, sem criar outra operação.
  • Mesma chave com corpo diferente: 409 idempotency_key_reuse.
Nos SDKs a chave é o último argumento:

Novas tentativas

Os SDKs tentam de novo em 429, 502, 503, 504 e erro de rede (até 2 vezes por padrão), mas só em leituras, exclusões e chamadas com chave de idempotência.
conversions.execute nunca é repetido automaticamente. Se a resposta não chegar, consulte a transação antes de cotar de novo.