Webhooks

The System sends a POST webhook to the Partner's configured URL when a payout transaction reaches a final status. The existing payout API calls these notifications callbacks.

HTTP method: POST

Content-Type: application/x-www-form-urlencoded

Webhook Parameters

Parameter Name Description
ID Transaction ID in the Partner's system
DT Date and time of the webhook notification
AMOUNT Payout transaction amount
RESULT Operation status code:
0 – fail;
1 – success
ERROR Payout error description (present when RESULT = 0)
DESTINATION Payout destination identifier
HASH Control signature: MD5(ID + DT + AMOUNT + RESULT + DESTINATION + secret_key)

Partner Response

The Partner must respond with any HTTP 2xx status code to confirm receipt.

Retry Strategy

If the System does not receive a 2xx response, the notification is retried with increasing delay. Duplicate notifications are possible; process the payout result idempotently. If no final webhook arrives, query the payout status or contact support with the transaction id.

Webhook Example

POST <Partner's webhook URL>
Content-Type: application/x-www-form-urlencoded;charset=UTF-8

ID=payout_001&DT=2026-03-05+22%3A26%3A40&AMOUNT=100.50&RESULT=0&ERROR=Insufficient+funds&DESTINATION=3&HASH=<calculated_hash>

Partner response: HTTP 200