Block - Блокировка средств на карте

Выполняется с помощью команды Block. Этот запрос позволяет блокировать денежные средства на карте Покупателя для последующего списания. В качестве карты может быть указан идентификатор зарегистрированной карты или полные реквизиты карты. Заблокированные средства далее могут быть списаны командой Charge или разблокированы командой Unblock.

Название Описание Формат Обязательный
Key Идентификатор Продавца. Выдается Продавцу с параметрами тестового/боевого доступа Строка Да
PayInfo Параметры для совершения транзакции Url Encoded строка, содержащая пары ключей и их значений команды, разделённые символом «;» (точка с запятой). Ключи и значения разделены символом «=» (равно) Обязательный при отсутствии CardUID
OrderId Идентификатор платежа в системе Продавца Строка (максимум 50 символов) Да
Amount Сумма блокировки в минимальных единицах валюты (копейках) Цифры, не содержащие десятичных или других разделителей Да
Login* Логин держателя карты, зарегистрированного в системе Продавца Строка (максимум 50 символов) Нет
Password* Пароль держателя карты, зарегистрированного в системе Продавца Строка (максимум 50 символов) Нет
CardUId Идентификатор карты в системе theMAP или значение «Random»** Строка (максимум 50 символов) Обязательный при отсутствии PayInfo
TerminalPassword*** Пароль терминала для совершения операций Строка (максимум 50 символов) Нет
Merchant**** Наименование продавца Строка (максимум 50 символов Нет
MerchantPassword**** Пароль Мерчанта для совершения операций Строка (максимум 50 символов) Нет
Goods Список наименований товаров/услуг для отправки в ОФД (54-ФЗ) Cтрока, содержащая пары ключей и их значений команды, разделённые символом «;» (точка с запятой). Ключи и значения разделены символом «=» (равно). Общая сумма всех товаров должна соответствовать Amount. Длина одного наименования - не более 128 символов Нет
Params Список дополнительных параметров операции Cтрока, содержащая пары ключей и их значений команды, разделённые символом «;» (точка с запятой). Ключи и значения разделены символом «=» (равно) Нет
Split Используется для разделение суммы произведенного списания на составные части для последующих расчетов с контрагентами Строка, содержащая группы пар ключ-значение, где группы содержатся в фигурных скобках {}, пары ключ-значение разделены символом «,» (запятая). Ключ и значение разделены символом «:» (двоеточие). Строка обособляется прямоугольными скобками «[]». Параметры ключей и значений выдаются Продавцу с параметрами тестового/боевого доступа. Общая сумма всех составных частей должна соответствовать Amount Нет

* - используются только в случае, если карта сохранена к конкретному пользователю
** - при указании значения «Random» выбирается случайная карта из привязанных к данному пользователю
*** - используются только в случае, если карта сохранена за терминалом
**** - используются только в случае, если карта сохранена за Мерчантом

Состав ключей параметра PayInfo

Название Описание Формат
PAN Номер карты или ее идентификатор PAN - цифры без пробелов
EMonth Месяц истечения срока действия карты 2 цифры с лидирующим нулём
EYear Год истечения срока действия карты 2 цифры (последние цифры года)
CardHolder Фамилия и имя держателя карты строка (максимум 30 символов, латинские буквы или пробел)
SecureCode CVC2/CVV2. Параметр является опциональным Цифры

Формат параметра Goods

Товар=Цена,Признак предмета расчета,Ставка НДС,Признак способа расчета|{Данные поставщика}
Название Описание Формат
Цена Сумма блокировки в минимальных единицах валюты (копейках) Цифры, не содержащие десятичных или других разделителей
Признак предмета расчета 1 – Товар, 2 – Подакцизный товар, 3 – Работа, 4 – Услуга, 5 – Ставка азартной игры, 6 – Выигрыш азартной игры, 7 – Лотерейный билет, 8 – Выигрыш лотереи, 9 – Предоставление РИД, 10 - Платеж, 11 – Агентское вознаграждение, 12 – Составной предмет расчета, 13 – Иной предмет расчета Число от 1 до 13. Параметр не обязательный. Значение по-умолчанию 1 – Товар
Ставка НДС 1 – ставка НДС 20%, 2 – ставка НДС 10%, 3 – ставка НДС расч. 20/120, 4 – ставка НДС расч. 10/110, 5 – ставка НДС 0%, 6 – НДС не облагается Число от 1 до 6. Параметр не обязательный. В случае отсутствия в запросе, значение берется из настроек терминала
Признак способа расчета 1 – Предоплата 100%, 2 – Частичная предоплата, 3 – Аванс, 4 – Полный расчет, 5 – Частичный расчет и кредит, 6 – Передача в кредит, 7 – оплата кредита Число от 1 до 7. Параметр не обязательный. В случае отсутствия в запросе, будет передано значение 4 – Полный расчет
Данные поставщика "name" - Наименование, "phoneNumbers" - список номеров телефонов, "supplierINN" - ИНН поставщика Строка JSON. Параметр не обязательный

Пример передачи Goods

Услуга=100,4,1,3|{"name": "ООО Ромашка", "phoneNumbers": ["+71111111111"],"supplierINN": "77777777"};Товар=810,1|{"name": "ООО Кармашка", "phoneNumbers": ["+71111114859"],"supplierINN": "777757777"};Услуга2=20,4;Товар2=30