> ## 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 Approval Webhook Events

> List of Payouts Approval webhook events along with sample payloads.

<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>
</div>

Assign user roles to create and approve payouts using the [Payouts Approval Workflow](/docs/api/x/payouts-approval).

## List of Payouts Approval Webhook Events

The table below lists the webhook events available for RazorpayX Payouts Approval.

| Webhook Event    | Description                                                                                                             |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `payout.pending` | Triggered whenever a payout moves to the pending state. The payout remains in this state till you approve or reject it. |

## Sample Payloads

Given below are the sample payloads for Payouts Approval webhook events.

### Payout Pending

<CodeGroup>
  ```json UPI theme={null}
  {
    "entity": "event",
    "account_id": "acc_BfVUrG6tDiL7H0",
    "event": "payout.pending",
    "contains": [
      "payout"
    ],
    "payload": {
      "payout": {
        "entity": {
          "id": "pout_1Aa00000000001",
          "entity": "payout",
          "fund_account": {
            "id": "fa_F681qr6Bqy1Je7",
            "entity": "fund_account",
            "contact_id": "cont_F681qmU11CfPDl",
            "contact": {
              "id": "cont_F681qmU11CfPDl",
              "entity": "contact",
              "name": "Gaurav Kumar",
              "contact": "9876543210",
              "email": "gaurav.kumar@example.com",
              "type": "employee",
              "reference_id": "Acme Contact ID 12345",
              "batch_id": null,
              "active": true,
              "notes": {
                "notes_key_1": "Tea, Earl Grey, Hot",
                "notes_key_2": "Tea, Earl Grey… decaf."
              },
              "created_at": 1592929016
            },
            "account_type": "bank_account",
            "vpa": {
              "username": "gaurav.kumar",
              "handle": "exampleupi",
              "address": "gaurav.kumar@exampleupi"
            }
          },
          "batch_id": "null",
          "active": true,
          "created_at": 1592929016
        },
        "amount": 100,
        "currency": "INR",
        "notes": {
          "note_key 1": "Tea. Earl Gray. Hot.",
          "note_key 2": "Tea. Earl Gray. Decaf."
        },
        "fees": 0,
        "tax": 0,
        "status": "pending",
        "purpose": "refund",
        "utr": null,
        "mode": "NEFT",
        "reference_id": null,
        "narration": "Test Fund Transfer",
        "batch_id": null,
        "status_details": {
          "description": "Confirmation of the credit to the beneficiary is pending from HDFC bank. Please check the status after 24th October 2021, 10:40 PM",
          "source": "beneficiary_bank"
        },
        "created_at": 1580808301
      }
    }
  }
  ```

  ```json Bank Account theme={null}
  {
    "entity": "event",
    "account_id": "acc_BfVUrG6tDiL7H0",
    "event": "payout.pending",
    "contains": [
      "payout"
    ],
    "payload": {
      "payout": {
        "entity": {
          "id": "pout_1Aa00000000001",
          "entity": "payout",
          "fund_account": {
            "id": "fa_F681qr6Bqy1Je7",
            "entity": "fund_account",
            "contact_id": "cont_F681qmU11CfPDl",
            "contact": {
              "id": "cont_F681qmU11CfPDl",
              "entity": "contact",
              "name": "Gaurav Kumar",
              "contact": "9876543210",
              "email": "gaurav.kumar@example.com",
              "type": "employee",
              "reference_id": "Acme Contact ID 12345",
              "batch_id": null,
              "active": true,
              "notes": {
                "notes_key_1": "Tea, Earl Grey, Hot",
                "notes_key_2": "Tea, Earl Grey… decaf."
              },
              "created_at": 1592929016
            },
            "account_type": "bank_account",
            "bank_account": {
              "ifsc": "HDFC0001234",
              "bank_name": "HDFC Bank",
              "name": "Gaurav Kumar",
              "notes": [],
              "account_number": "1121431121541121"
            },
            "batch_id": null,
            "active": true,
            "created_at": 1592929016
          },
          "amount": 100,
          "currency": "INR",
          "notes": {
            "note_key 1": "Tea. Earl Gray. Hot.",
            "note_key 2": "Tea. Earl Gray. Decaf."
          },
          "fees": 0,
          "tax": 0,
          "status": "pending",
          "purpose": "refund",
          "utr": null,
          "mode": "NEFT",
          "reference_id": null,
          "narration": "Test Fund Transfer",
          "batch_id": null,
          "status_details": {
            "description": "Confirmation of the credit to the beneficiary is pending from HDFC bank. Please check the status after 24th October 2021, 10:40 PM",
            "source": "beneficiary_bank"
          },
          "created_at": 1580808301
        }
      }
    }
  }
  ```
</CodeGroup>

<Warning>
  **Watch Out!**

  * If you have changed your webhook secret, remember to use the old secret for webhook signature validation while retrying older requests. Using the new secret will lead to a signature mismatch.

  * While generating a signature at your end, ensure that the webhook body is passed as an argument in the **raw webhook request body**. **Do not parse or cast the webhook request body**.
</Warning>