Выполняется с помощью команды storeCard.
Этот запрос позволяет сохранить реквизиты банковской карты Пользователя для последующей оплаты без ввода данных карты. Результатом обработки запроса является получение Продавцом идентификатора карты в theMAP.
В зависимости от бизнес-сценария, карта может быть сохранена:
Стандартный кейс сохранения карты на стороне theMAP - с привязкой к Логину Пользователя. В случае сохранения карты за Терминалом или за Мерчантом, соответсвие сохраненных карт с Пользователями производится на стороне Мерчанта. В ответе на запрос списка сохраненных карт в этом случае будет содержаться весь массив сохраненных карт.
Название | Описание | Формат | Обязательный |
---|---|---|---|
Key | Идентификатор Продавца. Выдается Продавцу с параметрами тестового/боевого доступа | Строка | Да |
OrderId | Идентификатор платежа в системе Продавца. Передается вместе с Amount | Строка (максимум 50 символов) | Нет |
Amount | Сумма блокировки в минимальных единицах валюты (копейках). При его использовании производится блокировка средств с карты клиента | Цифры, не содержащие десятичных или других разделителей | Нет |
Login* | Логин Пользователя. Используется для идентификации карт | Строка (максимум 50 символов) | Нет |
Password* | Пароль держателя карты, зарегистрированного в системе Продавца | Строка (максимум 50 символов | Нет |
PAN | Номер карты | Цифры без пробелов | Да**** |
EMonth | Месяц истечения срока действия карты | 2 цифры с лидирующим нулём | Да**** |
EYear | Год истечения срока действия карты | 2 цифры (последние цифры года) | Да**** |
CardHolder | Фамилия и имя держателя карты | строка (максимум 30 символов, латинские буквы или пробел) | Да**** |
SecureCode | CVC2/CVV2 | Цифры без пробелов | Да**** |
ApplePayToken | Одноразовый токен, получаемый в Apple Pay в момент инициирования оплаты с устройства Apple | Строка | Нет |
Params | Список дополнительных параметров операции | Cтрока, содержащая пары ключей и их значений команды, разделённые символом «;» (точка с запятой). Ключи и значения разделены символом «=» (равно) | Нет |
Recurrent | Необходимо использовать в случае, если сохраняемая карта будет использоваться для рекуррентных списаний. Возможность использования необходимо уточнить дополнительно | true/false | Нет |
Action | Дополнительное действие с заблокированной суммой. «Charge» - списание, «Unblock» - разблокировка | Charge/Unblock | Нет |
Enrollment | Признак вовлеченности карты в технологию 3D Secure. При этом сохраняется карта только указанного типа. «3DS» - карта вовлечена в технологию 3D Secure, «Non-3DS» - карта не вовлечена в технологию 3D Secure. Возможность использования необходимо уточнить дополнительно | 3DS/Non-3DS | Нет |
TerminalPassword** | Пароль терминала для совершения операций | Строка (максимум 50 символов | Нет |
Merchant*** | Наименование продавца | Строка (максимум 50 символов | Нет |
MerchantPassword*** | Пароль Мерчанта для совершения операций | Строка (максимум 50 символов | Нет |
Goods | Список наименований товаров/услуг для отправки в ОФД (54-ФЗ) | Cтрока, содержащая пары ключей и их значений команды, разделённые символом «;» (точка с запятой). Ключи и значения разделены символом «=» (равно). Общая сумма всех товаров должна соответствовать Amount | Нет |
Split | Используется для разделение суммы произведенного списания на составные части для последующих расчетов с контрагентами | Строка, содержащая группы пар ключ-значение, где группы содержатся в фигурных скобках {}, пары ключ-значение разделены символом «,» (запятая). Ключ и значение разделены символом «:» (двоеточие). Строка обособляется прямоугольными скобками «[]». Параметры ключей и значений выдаются Продавцу с параметрами тестового/боевого доступа. Общая сумма всех составных частей должна соответствовать Amount | Нет |
* - передаются вместе. Используются только в случае, если карта сохраняется за Пользователем
** - Используются только в случае, если карта сохраняется за терминалом
*** - передаются вместе. Используются только в случае, если карта сохраняется за Мерчантом
**** - обязательный в случае отсутствия параметра ApplePayToken в запросе
Параметры ответа в случае сохранения карты, вовлеченной в технологию 3-D Secure аналогичны параметрам, описанным в пункте Использование технологии 3D Secure. Для получения идентификатора карты, необходимо завершение 3DS аутентификации держателя (метод StoreCard3DS)