storeCard - Регистрация (сохранение) карты

Выполняется с помощью команды storeCard.

Этот запрос позволяет сохранить реквизиты банковской карты Пользователя для последующей оплаты без ввода данных карты. Результатом обработки запроса является получение Продавцом идентификатора карты в theMAP. В зависимости от бизнес-сценария, карта может быть сохраняется:

Стандартный кейс сохранения карты на стороне theMAP - с привязкой к Логину Пользователя. В случае сохранения карты за Терминалом или за Мерчантом, соответсвие сохраненных карт с Пользователями производится на стороне Мерчанта. В ответе на запрос списка сохраненных карт в этом случае будет содержаться весь массив сохраненных карт.

Название Описание Формат Обязательный
key Идентификатор Продавца. Выдается с параметрами тестового/боевого доступа Строка Да
merchant_order_id Идентификатор платежа в системе Продавца. Передается вместе с Amount Строка (максимум 50 символов) Да
amount Сумма блокировки в минимальных единицах валюты (копейках). При его использовании производится блокировка средств с карты клиента Целое число Нет
card Данные карты для совершения транзакции Объект Да*
├─ pan Номер карты или ее идентификатор Строка Да*
├─ emonth Месяц истечения срока действия карты Число Да*
├─ eyear Год истечения срока действия карты Число Да*
├─ cvv CVC2/CVV2. Параметр является опциональным Строка Да*
├─ holder Фамилия и имя держателя карты Строка Да*
apple_pay_token Одноразовый токен, получаемый в Apple Pay в момент инициирования оплаты с устройства Apple Строка Нет
custom_params_rdy Список дополнительных параметров операции в формате "ключ - значение" Объект формата {"param1":"test", "param2":"test"...} Нет
recurrent Необходимо использовать в случае, если сохраняемая карта будет использоваться для рекуррентных списаний. Возможность использования необходимо уточнить дополнительно у support@mapcard.pro true/false Нет
action Дополнительное действие с заблокированной суммой.

  1. "Charge" - списание
  2. "Unblock" - разблокировка
 строка "Charge"/"Unblock" Нет
enrollment Признак вовлеченности карты в технологию 3D Secure. При этом сохраняется карта только указанного типа. «3DS» - карта вовлечена в технологию 3D Secure, «Non-3DS» - карта не вовлечена в технологию 3D Secure. Возможность использования необходимо уточнить дополнительно строка "3DS"/"Non-3DS" Нет
credential Объект Нет
├─ login Логин держателя карты, зарегистрированного в системе Продавца.
Передаётся вместе с password. Используются только в случае, если карта сохраняется за Пользователем		 Строка (максимум 50 символов) Нет
├─ password Пароль держателя карты, зарегистрированного в системе Продавца.
Передаётся вместе с login. Используются только в случае, если карта сохраняется за Пользователем		 Строка (максимум 50 символов) Нет
├─ merchant_name Наименование продавца.
Передаётся вместе с merchant_password. Используются только в случае, если карта сохраняется за Мерчантом		 Строка (максимум 50 символов) Нет
├─ merchant_password Пароль Мерчанта для совершения операций.
Передаётся вместе с merchant_name. Используются только в случае, если карта сохраняется за Мерчантом		 Строка (максимум 50 символов) Нет
├─ terminal_password Пароль терминала для совершения операций.
Передаётся вместе с key. Используются только в случае, если карта сохраняется за терминалом		 Строка (максимум 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 Список номеров телефонов Массив Нет
      split Используется для разделение суммы произведенного списания на составные части для последующих расчетов с контрагентами. Общая сумма всех составных частей должна соответствовать amount Массив Нет
      ├─ split_terminal_id Номер терминала для проведения операции Число В случае передачи split параметр обязательный
      ├─ amount Сумма разделения Число В случае передачи split параметр обязательный
      ├─ purpose Описание Строка В случае передачи split параметр обязательный
      ├─ fee Размер комиссии Число В случае передачи split параметр обязательный

      * - Карточные данные обязательны при отсутствии параметра ApplePayToken в запросе

      * - Пример передачи 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}]

      Параметры ответа в случае сохранения карты, вовлеченной в технологию 3-D Secure аналогичны параметрам, описанным в пункте Использование технологии 3D Secure. Для получения идентификатора карты, необходимо завершение 3DS аутентификации держателя (метод StoreCard3DS)