> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay-881012b3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Payouts

> Create, fetch and cancel Payouts using APIs. Set up webhooks for notifications.

<div style={{display:"flex",flexWrap:"wrap",alignItems:"center",gap:"0.35rem 0.9rem",border:"1px solid rgba(128,128,128,0.28)",borderRadius:"0.5rem",padding:"0.45rem 0.75rem",margin:"0 0 1.25rem",fontSize:"0.875rem"}}>
  <span style={{fontWeight:600}}>Available in</span>
  <span>🇮🇳 India</span>
  <span>🇸🇬 Singapore</span>
</div>

A [payout](/docs/x/payouts) is a transfer of funds from your business account to a Contact's Fund Account(s). You can create and process payouts both on the RazorpayX Dashboard and via the Payouts API. Ensure to [create a contact](/docs/api/x/contacts/create) and add a [fund account](/docs/api/x/fund-accounts).

<Check>
  **What's New**

  [Idempotency Key](/docs/api/x/payout-idempotency) is mandatory for all payout requests starting March 15, 2025.
</Check>

<br />

To make payouts, you must [allowlist IPs](/docs/x/dashboard/allowlist-ip) and pass the [idempotency key](/docs/api/x/payout-idempotency).

<br />

Making payouts from [RazorpayX Lite](/docs/x/account-types/razorpayx-lite) account to RazorpayX Lite Customer Identifiers or Razorpay [Customer identifiers](/docs/payments/smart-collect) is not supported.

<br />

Fork the Razorpay Postman Public Workspace and try the Payouts APIs using your [Test API Keys](/docs/x/dashboard/api-keys).
<a href="https://www.postman.com/razorpaydev/workspace/razorpay-public-workspace/folder/12492020-117c93d1-1a79-4958-9067-eb97a3459f08" target="_blank">![Run in Postman](https://run.pstmn.io/button.svg)</a>

<CardGroup cols={2}>
  <Card title="Creates a Payout to a Bank Account" href="/docs/api/x/payouts/create/bank-account">
    `POST` `
        /v1/payouts`

    Create a payout to a bank account.
  </Card>

  <Card title="Create a Payout to a VPA" href="/docs/api/x/payouts/create/vpa">
    `POST` `
        /v1/payouts`

    Creates a payout to a VPA.
  </Card>

  <Card title="Fetch all Payouts" href="/docs/api/x/payouts/fetch-all">
    `GET` `/v1/payouts?account_number=\{account number\}`

    Retrieves details of all the payouts.
  </Card>

  <Card title="Fetch a Payout with ID" href="/docs/api/x/payouts/fetch-with-id">
    `GET` `/v1/payouts/:id`

    Retrieves details of one payout via ID.
  </Card>

  <Card title="Cancel a Queued Payout" href="/docs/api/x/payouts/cancel">
    `PATCH` `/v1/payouts/:id/cancel`

    Cancels a payout in `queued` state.
  </Card>
</CardGroup>

## Related Guides

* [About Payouts](/docs/x/payouts)
* [Set up Webhooks](/docs/webhooks/setup-edit-payouts)
* [Webhooks Payloads](/docs/webhooks)