Skip to main content

Idempotency

Idempotency lets you safely retry a POST /transactions request without risking a duplicate charge. If a request times out or your connection drops before you receive a response, you can retry with the same idempotencyKey and Payments AI treats the retry as the same operation rather than a new one.

Pass idempotencyKey in the POST /transactions request body. Maximum 100 characters. See the Transactions reference for the field.

Behavior on retry

When Payments AI receives a POST /transactions request whose idempotencyKey matches one it has already processed, it returns the result of the original operation instead of creating a second transaction.