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.

📘

Idempotency keys last for at least 24 hours

After 24 hours, a given idempotency key is not guaranteed to protect against duplicate effects. Please do not reuse an idempotency key more than 24 hours after it was first used.

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.