Notification parameters

Learn how to receive payout notifications.

The Payouts API will send notifications to your notification URL using the POST protocol whenever there is a change in payout status.

If you need to specify a port in the notification URL, it must be the standard HTTPS port 443, and the connection must use TLS 1.2.

Parameters

The following is a list of the parameters included in the notification POST message:

FieldFormatDescription
external_idString (max. 100 chars)Payout identification (at the Merchant Dashboard). Example: payout1234
cashout_idNumber (max. 10 chars)Payout identification (at Merchant Dashboard). Example: 10050
dateFormat: YYYY-MM-DD HH:MM:SS (GMT)The date when the status changed. Example: 2015-10-03 15:32:01
bank_reference_idString (max. 50 chars)Number reference at the bank. Example: 513512.04198.5
commentsString (max. 200 chars)Payout comment. Example: This is a comment.
status_reasonString (max. 200 chars)Status reason (if available). Example: ERROR_ACCOUNT_INCORRECT
controlString (max. 100 chars)V2-HMAC-SHA256 signature. Example: FOR59E6E3F1353305181E1DCA20...

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