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

Выполняется с помощью команды 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. В случае отсутствия в запросе, значение берется из настроек терминала

  1. 1 – ставка НДС 20%
  2. 2 – ставка НДС 10%
  3. 3 – ставка НДС расч. 20/120
  4. 4 – ставка НДС расч. 10/110
  5. 5 – ставка НДС 0%
  6. 6 – НДС не облагается
Число Нет
├─ payment_subject_type Признак предмета расчета. Целое число от 1 до 13. Параметр не обязательный, в случае отсутствия в запросе, будет передано значение 1 – Товар.

  1. 1 – Товар
  2. 2 – Подакцизный товар
  3. 3 – Работа
  4. 4 – Услуга
  5. 5 – Ставка азартной игры
  6. 6 – Выигрыш азартной игры
  7. 7 – Лотерейный билет
  8. 8 – Выигрыш лотереи
  9. 9 – Предоставление РИД
  10. 10 - Платеж
  11. 11 – Агентское вознаграждение
  12. 12 – Составной предмет расчета
  13. 13 – Иной предмет расчета
  14. Число Нет
    ├─ payment_method_type Признак способа расчета. Целое число от 1 до 7. Параметр не обязательный, в случае отсутствия в запросе, будет передано значение 4 – Полный расчет.

    1. 1 – Предоплата 100%
    2. 2 – Частичная предоплата
    3. 3 – Аванс
    4. 4 – Полный расчет
    5. 5 – Частичный расчет и кредит
    6. 6 – Передача в кредит
    7. 7 – Оплата кредита
    8. Число Нет
      ├─ 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}]