Payout Idempotency API

Razorpay uses Idempotency Key for payout API requests, so that the requests can be retried safely. The Idempotency Key is a unique value that you generate which will be used to recognize subsequent retries of the same request. This is useful when an API request is disrupted during transit. Razorpay saves the response to the first request made with an Idempotency Key. Subsequent requests using the same key will return the saved result, thereby avoiding duplication. Hence we recommend you to use the same Idempotency Key for all attempts of the same payout until it is processed or failed.

Consider that you are attempting a payout.

• You have generated an Idempotency Key and initiated the payout.
• There is a network issue and the system does not return a processed value.
• After sometime, you retry the payout using the same Idempotency Key.
• The system maps both attempts to a single payout because of the same Idempotency Key used.
• The payout is processed only once. There is no duplication because of the same Idempotency Key used.
• If the payout returns a failed state, it means all attempts using the same Idempotency Key are failed.
• You generate a new key to retry the payout.

To use the Payout Idempotency API, you must

and create a Fund Account (using details or ). Ensure to that you use while making payouts via APIs or the request will fail.

Fork the Razorpay Postman Public Workspace and try the Payout Idempotency API using your

.