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

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

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

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

Название Описание Формат eCom AP
key Идентификатор Продавца. Выдается с параметрами тестового/боевого доступа Строка
merchant_order_id Идентификатор платежа в системе Продавца. Передается вместе с Amount Строка (максимум 50 символов)
amount Сумма блокировки в минимальных единицах валюты (копейках). При его использовании производится блокировка средств с карты клиента Целое число
card1 Данные карты для совершения транзакции Объект
├─ 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 Пароль держателя карты, зарегистрированного в системе Продавца.
Передаётся вмес
├─ merchant_name Наименование продавца.
Передаётся вместе с merchant_password. Используются только в случае, если карта сохраняется за Мерчантом
Строка (максимум 50 символов)
├─ merchant_password Пароль Мерчанта для совершения операций.
Передаётся вместе с merchant_name. Используются только в случае, если карта сохраняется за Мерчантом
Строка (максимум 50 символов)
├─ terminal_password Пароль терминала для совершения операций.
Передаётся вместе с key. Используются только в случае, если карта сохраняется за терминалом
Строка (максимум 50 символов)
split Используется для разделение суммы произведенного списания на составные части для последующих расчетов с контрагентами. Общая сумма всех составных частей должна соответствовать amount Массив объектов
├─ split_terminal_id2 Номер терминала для проведения операции Число
├─ amount2 Сумма разделения Число
├─ purpose2 Описание Строка
├─ fee2 Размер комиссии Число

Для использования функционала фз-54 необходимо прописать дополнительные параметры в запрос.

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

2 При передаче split параметр обязательный

Пример передачи split:

"split": [{"split_terminal_id": 1,"amount": 150,"purpose": "Test1","fee": 10},{"split_terminal_id": 2,"amount": 150,"purpose": "Test2","fee": 10}]

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