Сервис нотификаций

Нотификации представляют собой уведомления (POST), содержащие информацию о проведенной операции, отправляемые на адрес URL, указанный Мерчантом заранее в письме на support@mapcard.pro. Сервис отправляет следующие типы нотификаций:

Тип нотификации Описание
Block Уведомление о блокировке средств
Block3DS Уведомление о блокировке средств в случае использования технологии 3D Secure
Unblock Уведомление о разблокировке
Charge Уведомление о списании
Refund Уведомление о возврате
Pay Уведомление об одностадийном списании (метод Pay)
Pay3DS Уведомление об одностадийном списании в случае использования технологии 3D Secure (метод Pay3DS)
AddCard Уведомление о сохранении карты

Состав полей уведомлений:

Параметр Описание Формат
MerchantContract Идентификатор Продавца. Строка
OriginalOrderId Идентификатор платежа в системе Продавца Строка
MerchantOrderId Уникальный идентификатор платежа в системе theMAP Строка
Amount Сумма операции в копейках Соответствует переданной в запросе
AuthCode Код авторизации Строка
RRN RRN операции Строка
Success Флаг успешности операции true/false
CardNumber Маскированный номер карты 411111xxxxxx1111
ErrCode Код ошибки Строка
State Статус заказа на момент отправки нотификации Строка
Notification Тип нотификации Строка
CardUID Идентификатор карты в системе MAP. Передается нотификации с типом AddCard, а так же в случае оплаты с использованием CardUID Строка
CustomParams Параметр является опциональным. Список дополнительных параметров операции Строка
FeePercent Параметр является опциональным. Ставка комиссии за эквайринг Число (cотые доли процента)
TerminalID Параметр является опциональным. Id терминала в системе MAP, по которому фактически выполнена операция Число
Signature Параметр является опциональным. Строка - результат хэширования по алгоритму SHA-256, URL encoded строки параметров, которые отправляются в нотификации, отсортированных по алфавиту Строка

По результату отправки нотификаций, по согласованию с Мерчантом, может быть настроено активное действие по заказу. Например, в случае получения 422-го кода ответа на нотификацию Block, или неполучения ответа в установленный срок, theMAP самостоятельно инициирует разблокировку средств. Функционал опциональный.