Callback-уведомления

Callback отправляется методом POST на callback_url, переданный при создании операции.

Заголовки

Content-Type: application/json

Основные поля

Поле	Тип	Описание
token	string	Token операции
type	string	Тип операции: pay, payout или refund
status	string	Статус операции
extraReturnParam	string/null	Значение, переданное мерчантом
orderNumber	string/null	Номер заказа мерчанта
amount	integer	Сумма в минимальных единицах валюты
currency	string	Валюта операции
gatewayAmount	integer	Сумма на стороне провайдера
gatewayCurrency	string	Валюта на стороне провайдера
cardHolder	string/null	Имя держателя карты
gatewayDetails	object/null	Дополнительные данные провайдера
walletToken	string/null	Token кошелька
signature	string	MD5-подпись callback

gatewayDetails

Состав объекта зависит от провайдера. Он может содержать:

Поле	Тип	Описание
ip	object	Географические данные IP
bin	object	Данные платёжного инструмента
merchant	object	Технические данные мерчанта
requisite_type	string	Тип реквизита
redirect_request	object	Параметры редиректа
recurring	object/null	Данные рекуррентной операции

Идемпотентность

Платформа может доставить одно callback-уведомление повторно. Уникальность обработки определяется на стороне мерчанта по token и состоянию операции.

Алгоритм проверки signature описан в Валидации подписи.