Payouts Approvals Webhooks

Assign user roles to create and approve payouts using the

Payout Approval Workflow

List of Payouts Approval Webhook Events

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

Sample Payloads

Given below are the sample payloads for Payouts Approvals webhooks.

Payout Pending

{
  "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
    }
  }
}

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.