Pular para o conteúdo principal

Chave de idempotência nas transações

Agora você pode enviar uma chave de idempotência ao criar transações. Ela garante que a mesma transação não seja registrada duas vezes, por exemplo, quando uma requisição é repetida após uma falha de rede ou um timeout.

O endpoint Create Transaction aceita o header opcional idempotency-key: um identificador único da transação, gerado pelo seu sistema (como um UUID ou o código da operação no seu banco de dados).

  • A chave é única por portfólio. A mesma chave pode ser usada em portfólios diferentes.
  • Se a requisição for enviada com uma chave já usada no portfólio, a transação não é criada e a API responde com o erro HTTP 409 Conflict (idempotency key already used).
  • Sem o header, cada requisição cria uma nova transação, mesmo que os dados sejam idênticos.

Saiba mais em Transação.