> ## Documentation Index
> Fetch the complete documentation index at: https://www.cashfree.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Settlement Webhooks
> Subscribe to Cashfree settlement webhooks so your reconciliation system is alerted whenever a payout to your merchant or vendor account completes.
We broadly send two types of notifications when a payout happens.
1. Payout to Merchant account
2. Payout to Vendor account (if you are using Easy Split)
## Settlement Webhook
This webhook is triggered whenever there is a payout to your merchant account. The settlement webhooks will notify you about instant settlements in addition to the standard settlement webhooks. We send webhooks for four different events for a `settlement`.
| Webhook event | Description |
| - | - |
| SETTLEMENT\_INITIATED | This webhook will be triggered when a settlement is initiated. |
| SETTLEMENT\_SUCCESS | This webhook will be triggered when a settlement is successful. |
| SETTLEMENT\_FAILED | This webhook will be triggered when a settlement has failed. |
| SETTLEMENT\_REVERSED | This webhook will be triggered when a settlement has been reversed. |
The following webhook is sent for other types of settlements as well: instant settlement or an on-demand settlement.
```javascript Settlement webhook theme={"dark"}
{
"data": {
"settlement": {
"adjustment": 0,
"amount_settled": 97.94,
"payment_amount": 100,
"payment_from": "2022-02-14 12:00:00",
"payment_till": "2022-02-14 12:15:00",
"reason": null,
"service_charge": 1.75,
"service_tax": 0.31,
"settled_on": "2022-02-14T12:35:19+05:30",
"settlement_type": "STANDARD", //settlement type //
"settlement_amount": 97.94,
"settlement_id": 738,
"settlement_initiated_on": "2022-02-14T12:35:17+05:30",
"status": "SUCCESS",
"utr": 1644822317781212,
"settlement_charge": 0, // applicable for instant settlement //
"settlement_tax": 0, // applicable for instant settlement //
"remarks": null. // applicable for instant settlement //
}
},
"event_time": "2022-02-08T13:37:34+05:30",
"type": "SETTLEMENT_SUCCESS"
}
```
## Payload field description
| Field | Description | Example |
| - | - | - |
| adjustment | Sum of refunds, disputes, and chargebacks included in this settlement. | 0 |
| amount\_settled | Total amount settled in this schedule. | 15 |
| payment\_amount | Total transaction amount considered for settlement. | 15 |
| payment\_from | Start date and time from which payments are considered for settlement. | 2022-02-14 12:00:00 |
| payment\_till | End date and time till which payments are considered for settlement. | 2022-02-23 12:00:00 |
| reason | Reason for failed or reversed settlements. | Transfer mode not valid for beneficiary. |
| service\_charge | Service charges applicable to the payments included in this settlement. | 2 |
| service\_tax | Service tax applicable to the payments included in this settlement. | 0 |
| settled\_on | Date and time when the settlement was processed. | 2022-03-17T14:21:18+05:30 |
| settlement\_type | Type of settlement (e.g., INSTANT). | INSTANT |
| settlement\_amount | Net settlement amount for the payments included in this settlement. | 13 |
| settlement\_id | Unique settlement ID generated by Cashfree. | 1155353 |
| settlement\_initiated\_on | Date on which settlement was initiated. | 2022-03-17T14:29:21+05:30 |
| status | Status of the settlement (INITIATED, SUCCESS, FAILED, or REVERSED). | SUCCESS |
| utr | Unique transaction reference number provided by the bank for the settlement. | N076221079016329 |
| settlement\_charge | Additional charge applicable for instant settlement. | 10.10 |
| settlement\_tax | Settlement tax applicable for instant settlement. | 01.97 |
| remarks | Any remarks specified by the merchant. | Settlement Initiated |
| event\_time | Time when the settlement webhook was triggered. | 2022-03-17T14:29:23+05:30 |
| type | Type of webhook event (SETTLEMENT\_INITIATED, SETTLEMENT\_SUCCESS, SETTLEMENT\_FAILED, or SETTLEMENT\_REVERSED). | SETTLEMENT\_SUCCESS |
## Vendor Settlement Webhook
This section only applies to merchants using our Easy Split product
These settlement webhooks automate notifications when vendor settlements are initiated, successfully processed, failed, or reversed.
| Webhook event | Description |
| :- | :- |
| VENDOR\_SETTLEMENT\_INITIATED | This webhook will be triggered when a vendor settlement is initiated. |
| VENDOR\_SETTLEMENT\_SUCCESS | This webhook will be triggered when a vendor settlement is successful. |
| VENDOR\_SETTLEMENT\_FAILED | This webhook will be triggered when a vendor settlement has failed. |
| VENDOR\_SETTLEMENT\_REVERSED | This webhook will be triggered when a vendor settlement has been reversed. |
```javascript Vendor Settlement Webhook theme={"dark"}
{
"data": {
"settlement": {
"adjustment": 0,
"amount_settled": 10,
"payment_amount": null,
"payment_from": "2022-05-26",
"payment_till": "2022-05-26",
"reason": null,
"service_charge": 0.05,
"service_tax": 0.01,
"settled_on": "2022-05-26T15: 06: 14+05: 30",
"settled_orders_count": null,
"settlement_amount": 10,
"settlement_id": 6151,
"settlement_initiated_on": "2022-05-26T15: 06: 09+05: 30",
"settlement_type": null,
"status": "CREATED",
"utr": null,
"vendor_id": IS_1hour_Upi,
"vendor_transaction_amount": 10
},
"event_time": "2022-05-26T15:06:15+05:30",
"type": "VENDOR_SETTLEMENT_INITIATED"
}
}
```
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.