Learn all about receiving a notification. When and how.
The Payouts API will send notifications to your Notification URL using the POST protocol whenever there is a payout status change. The following is a list of the parameters included in the notification POST message:
| Field | Format | Description | Example |
|---|---|---|---|
external_id | String (max. 100 chars) | Payout identification (at the Merchant Dashboard). | payout1234 |
cashout_id | Number (max. 10 chars) | Payout identification (at Merchant Dashboard). | 10050 |
date | Format: YYYY-MM-DD HH:MM:SS (GMT) | The date when the status changed. | 2015-10-03 15:32:01 |
bank_reference_id | String (max. 50 chars) | Number reference at the bank. | 513512.04198.5 |
comments | String (max. 200 chars) | Payout comment | This is a comment. |
status_reason | String (max. 200 chars) | Status reason (if available) | ERROR_ACCOUNT_INCORRECT |
control | String (max. 100 chars) | V2-HMAC-SHA256 signature | FOR59E6E3F1353305181E1DCA204157FF47D1F014F4FB603EF4 |
Example
Content-Type: application/x-www-form-urlencoded
external_id=ext123
cashout_id=123456
date=2021-04-29 02:16:24
bank_reference_id=ref321
comments=Merchant
status_reason=ERROR_ACCOUNT_INCORRECT
control=FOR59E6E3F1353305181E1DCA204157FF47D1F014F4FB603EF4