Нотификации представляют собой уведомления (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 самостоятельно инициирует разблокировку средств. Функционал опциональный.