The Circle APIs support idempotent requests so that you can safely retry API calls when things go wrong before you receive a response.
For instance, let's say you were creating a payment but before you received a response there was a network connection issue. Did the payment get created? Is it safe to retry or are you going to charge your end user multiple times?
To allow you to retry certain requests without causing the operation to be executed multiple times, Circle APIs'
POST operations have an idempotency body parameter called
To ensure a request is idempotent you have to generate and provide such parameter. Subsequent requests with the same
idempotencyKey parameter value will produce the same result as the initial request.
idempotencyKeybody parameter has to be sent in UUID format.
The following Circle API operations support idempotent requests. Check the API reference for more details.
- Core Functionality
- Payments API
- Payouts API
- Digital Dollar Accounts API
- Marketplaces API
Updated about a month ago