Выполняется с помощью команды 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 – ставка НДС 20%, 2 – ставка НДС 10%, 3 – ставка НДС расч. 20/120, 4 – ставка НДС расч. 10/110, 5 – ставка НДС 0%, 6 – НДС не облагается | Число от 1 до 6. Параметр не обязательный. В случае отсутствия в запросе, значение берется из настроек терминала |
| Данные поставщика | "name" - Наименование, "phoneNumbers" - список номеров телефонов, "supplierINN" - ИНН поставщика | Строка JSON. Параметр не обязательный |
Пример передачи Goods
Услуга=100,4,1|{"name": "ООО Ромашка", "phoneNumbers": {["+71111111111"]},"supplierINN": "77777777"};Usluga=810,2|{"name": "ООО Кармашка", "phoneNumbers": {["+71111114859"]},"supplierINN": "777757777"};Услуга2=20,4;Товар=30