Выполняется с помощью команды Block. Этот запрос позволяет блокировать денежные средства на карте Покупателя для последующего списания. В качестве карты может быть указан идентификатор зарегистрированной карты или полные реквизиты карты. Заблокированные средства далее могут быть списаны командой Charge или разблокированы командой Unblock.
Название | Описание | Формат | Обязательный |
---|---|---|---|
key |
Идентификатор Продавца. Выдается с параметрами тестового/боевого доступа | Строка | Да |
card |
Данные карты для совершения транзакции | Объект | Обязательно при отсутствии идентификатора карты - uid |
├─ pan |
Номер карты или ее идентификатор | Строка | Нет |
├─ emonth |
Месяц истечения срока действия карты | Число | Нет |
├─ eyear |
Год истечения срока действия карты | Число | Нет |
├─ cvv |
CVC2/CVV2. Параметр является опциональным | Строка | Нет |
├─ holder |
Фамилия и имя держателя карты | Строка | Нет |
├─ uid |
Идентификатор карты в системе theMAP или значение «Random». При указании значения «Random» выбирается случайная карта из привязанных к данному пользователю | Строка (максимум 30 символов, латинские буквы или пробел) | Обязателен при отсутствии pan, emonth, eyear, cvv, holder |
merchant_order_id |
Идентификатор платежа в системе Продавца | Строка (максимум 50 символов) | Да |
amount |
Сумма блокировки в минимальных единицах валюты (копейках) | Целое число | Да |
credential |
Объект | Нет | |
├─ login |
Логин держателя карты, зарегистрированного в системе Продавца. Используются только в случае, если карта сохранена к конкретному пользователю | Строка (максимум 50 символов) | Нет |
├─ password |
Пароль держателя карты, зарегистрированного в системе Продавца. Используются только в случае, если карта сохранена к конкретному пользователю | Строка (максимум 50 символов) | Нет |
├─ merchant_name |
Наименование продавца. Используются только в случае, если карта сохранена за Мерчантом | Строка (максимум 50 символов) | Нет |
├─ merchant_password |
Пароль Мерчанта для совершения операций. Используются только в случае, если карта сохранена за Мерчантом | Строка (максимум 50 символов) | Нет |
├─ terminal_password |
Пароль терминала для совершения операций. Используются только в случае, если карта сохранена за терминалом | Строка (максимум 50 символов) | Нет |
goods* |
Список наименований товаров/услуг для отправки в ОФД (54-ФЗ). Общая сумма всех товаров должна соответствовать amount |
Массив объектов | Нет |
├─ name |
Наименование товара/услуги, не более 128 символов | Строка | В случае передачи goods параметр обязательный |
├─ price |
Сумма блокировки в минимальных единицах валюты (копейках) | Строка | В случае передачи goods параметр обязательный |
├─ tax |
Ставка НДС. Целое число от 1 до 6. В случае отсутствия в запросе, значение берется из настроек терминала
|
Число | Нет |
├─ payment_subject_type |
Признак предмета расчета. Целое число от 1 до 13. Параметр не обязательный, в случае отсутствия в запросе, будет передано значение 1 – Товар. |
Число | Нет |
├─ payment_method_type |
Признак способа расчета. Целое число от 1 до 7. Параметр не обязательный, в случае отсутствия в запросе, будет передано значение 4 – Полный расчет. |
Число | Нет |
├─ supplier |
Данные поставщика. Опциональное поле в товаре | Объект | Нет |
├── name |
Наименование | Строка | В случае передачи supplier параметр обязательный |
├── inn |
ИНН поставщика | Строка | В случае передачи supplier параметр обязательный |
├── phone_numbers |
Список номеров телефонов | Массив | Нет |
custom_params_rdy |
Список дополнительных параметров операции в формате "ключ - значение" | Объект | Нет |
split |
Используется для разделение суммы произведенного списания на составные части для последующих расчетов с контрагентами. Общая сумма всех составных частей должна соответствовать amount |
Массив | Нет |
├─ split_terminal_id |
Номер терминала для проведения операции | Число | В случае передачи split параметр обязательный |
├─ amount |
Сумма разделения | Число | В случае передачи split параметр обязательный |
├─ purpose |
Описание | Строка | В случае передачи split параметр обязательный |
├─ fee |
Размер комиссии | Число | В случае передачи split параметр обязательный |
* - Пример передачи goods
:
"goods": [{"name": "Mock1","price": "500","tax": 2,"payment_subject_type": 3,"payment_method_type": 4,"supplier": {"name": "ООО Ромашка","inn": "123456789112","phone_numbers": [" 71111111111"]}},{"name": "Mock2","price": "500","tax": 3,"payment_subject_type": 1,"payment_method_type": 6,"supplier": {"name": "test","supplierINN": "123","phoneNubmers": ["1","2"]}},{"name": "Mock3","price": "500","tax": 3,"payment_subject_type": 6,"payment_method_type": 4},{"name": "Mock4","price": "500","tax": 1,"payment_subject_type": 1,"payment_method_type": 4}]