Выполняется с помощью команды 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