Callback

Webhook notifications are sent to the specified webhook_url, which you provide when creating the transaction. They notify you about the payment status (successful or unsuccessful) of the request. A webhook notification is considered delivered if your server returns a 200 status and OK response in plain text.

Follow-up webhook notifications are possible, so it is recommended to check whether the previous notification has already been processed to avoid duplication.

This documentation describes how to configure your server to receive and process webhook notifications about the results of payout requests. The notification contains information about the payment status, amount and a unique transaction ID. For security purposes a signature is used and it must be verified.

Request

After the payment processing is complete, your application will receive a POST request to the URL provided in the webhook_url parameter when the transaction was created.

Webhook notification example

{
   "payout_deal_id": "f0b1b3b4-0b1b-4b3b-8b1b-3b4b5b6b7b8b",
   "state": "completed",
   "amount": "1000",
   "currency": "RUB",
   "amount_usdt": "10",
   "order_id": "0001",
   "signature": "md5",
   "status_code": 700
}

Body

Name	Type	Описание
payout_deal_id	string	Unique identifier of transaction
state	string	Current status of transaction (completed, processing, etc.)
amount	string (number)	Payment amount in fiat currency
currency	string	Payment currency RUB
amount_usdt	string	Amount of transaction in USDT
order_id	string	Internal application number
signature	string	Signature for authentication of the notification (formed using a secret word)
status_code	string (number)	Result of transaction (for example, 700 for a successful transaction)

Signature verification

To authenticate the notification, you must generate an MD5 signature using the following line:

md5(deal_id:amount:secret_word_2)

Сompare this hash with the signature received in the signature field of the webhook notification. If the signatures match, it means the notification has been sent from our server.

Payouts status

Name	Description
created	New transaction (deal)
completed	Transaction completed (final status)
processing	Transaction is in progress
waiting_result	Awaiting final status
rejected_balance	Insufficient cashier balance to complete the payment (final status)
rejected_by_system	Rejected internally or because method is not available (final status)
rejected_timeout	Rejected due to payment timeout or failure (final status)

Response status codes

Name	Description
700	Transaction completed successfully
721	Not enough funds at the merchant cashier
722	Transaction has not been completed within the required timeframe
723	Failed to execute the request
725	Cancellation by the payment system due to impossibility of transfer