Payouts
Payout Webhooks
Receive notifications when payout transaction status changes.
Payout Webhooks
API Version: 3.0.0
When you send a callback_url in a Single Payout or Bulk Payout request, PayOrc sends an HTTP POST to that URL when the payout status changes.
Send callback_url as "" if you do not want webhooks. You can still check status using Payout Status or Payout Statement.
Delivery
| Item | Value |
|---|---|
| Method | POST |
| Content-Type | application/json |
| Timeout | 5 seconds |
| Retries | None — one delivery attempt per status event |
Your endpoint should respond with HTTP 200 within 5 seconds.
If delivery fails, PayOrc does not retry the webhook. Use the Payout Status API to fetch the latest status.
When webhooks are sent
A webhook is sent for status changes such as QUEUED, PROCESSING, SUCCESS, FAILED, and CANCELLED. You may receive multiple webhooks for the same transaction_id as the status progresses.
Status values
| Status | Description |
|---|---|
QUEUED | Received and queued for processing |
PROCESSING | Currently being processed |
SUCCESS | Successfully completed |
FAILED | Failed — check reason |
CANCELLED | Cancelled |
Payload fields
| Field | Type | Description |
|---|---|---|
transaction_id | String | PayOrc payout ID (e.g. PY260217164600000007) |
status | String | Current status (QUEUED, PROCESSING, SUCCESS, FAILED, CANCELLED) |
reference_no | String | Your reference from the payout request |
amount | String | Payout amount (e.g. 100.00) |
currency | String | Currency code (e.g. INR) |
payment_mode | String | NEFT, RTGS, IFT, IMPSP2A, or IMPSP2P |
date | String | Timestamp (YYYY-MM-DD HH:mm:ss) |
remark | String | Remark from the payout request |
reason | String | Failure reason when status is FAILED; otherwise empty |
bank_reference_no | String | Bank UTR/reference when available |
beneficiary | Object | Beneficiary details (same shape as Payout Status response) |
Payload example
{
"transaction_id": "PY260217164600000007",
"status": "SUCCESS",
"reference_no": "REF299206",
"amount": "100.00",
"currency": "INR",
"payment_mode": "NEFT",
"date": "2026-02-17 16:46:32",
"remark": "test",
"reason": "",
"bank_reference_no": "KVBLH00244742734",
"beneficiary": {
"account_number": "100060539676",
"account_type": "SA",
"ifsc": "INDB0000542",
"branch": "",
"name": "pallavi",
"email": "[email protected]",
"mobile": "9876543213",
"mmid": "",
"lei_code": "",
"nre_flag": "EX"
}
}