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

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

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

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

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

Нотификации отправляются до получения кода ответа 200 или истечения тайм-лимита. При получении другого ответа, сервис отправляет нотификации повторно, с увеличением интервала между попытками отправки по экспоненте.

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