Skip to main content

​
Idempotency

The Issuing API supports the submission of idempotent requests for all POST requests. This enables you to retry a request multiple times while only performing the action once and helps avoid unwanted duplication in case of failures and retries. If a transient error or a time-out occurred and the action was not completed in the previous request, the subsequent retry pushes the action to its completion. If the action is already completed, the action is to be performed only once and the same result is to be returned for the retry process. All UTGL payment-related APIs are idempotent. If you resubmit the same request with the same idempotency key, the request will not trigger the same operation again. However, the original response will be returned. If you experience network errors or delays while submitting a transaction, you can use this feature to make sure that the same transaction is not submitted multiple times.

​
Idempotency Fields

The following table lists the idempotency fields used by the Issuing API.
HeaderDescription
Idempotency-KeyA UUID key used to serve as request level idempotency
To make an idempotent request, please add Idempotency-Key: $key header to your POST request. For any request with the Idempotency-Key header, we will store the response and re-send it for every request for the same idempotency key for 24H.