Skip to main content
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.
Watch Out!
  • Idempotency key has been made mandatory for all payout requests since March 15, 2025.
  • Ensure that you do not retry the same payout using a fresh Idempotency Key when the first attempt is still processing. The system will treat them as different payouts and will process both resulting in duplication. To use the Payout Idempotency API, you must create a Contact and create a Fund Account (using bank account details or VPA). Ensure to allowlist the IPs 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 Test API Keys.
About Payouts Set Up Webhooks Payouts APIs

​
Endpoints

  • post /v1/payouts - Make an Idempotent Request: Requests for an idempotent payout.