Idempotency

Ansa's APIs support idempotency to safely retry requests without accidentally performing the same operation twice. For example, this is helpful for avoiding accidentally charging a customer twice.

API calls can fail due to network errors or other transient problems. By using the same idempotency key, you can retry a request with the assurance that you won't unintentionally create a duplicate charge.

🚧

Keys will have a lifetime of at least 24 hours

After this period, idempotency keys may be eligible for garbage collection. Please do not intentionally reuse an idempotency key after the 24-hour window. Ansa does not guarantee a timeline for when an individual key will be valid for reuse.

If no idempotency key is provided, Ansa Core will manage this for you as part of the session. If you do want to manage idempotency on your own, it is possible to override the idempotency key used in the request by providing it as a parameter in most calls.