Init - Создание платежной сессии

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

При получении идентификатора сессии возможно указание цели использования платежной формы - для блокировки средств на карте или для сохранения карты в хранилище theMAP для последующих списаний. В случае сохранения карты последующие списания могут производиться как с вводом CVV2/CVC2, так и безакцептно – без ввода каких-либо данных и участия держателя карты. Это могут быть рекуррентные списания или классические транзакции без ввода CVV2/CVC2. В последнем случае возможны отказы из-за ограничений эмитента в связи с необходимостью применения технологии 3-D Secure.

Страница оплаты может быть оформлена в дизайне Продавца и не является уникальной (Продавец может иметь несколько страниц ввода данных для разных случаев).

Название Описание Формат eCom AP GP SBP
key Идентификатор Продавца. Выдается с параметрами тестового/боевого доступа Строка
merchant_order_id Идентификатор платежа в системе Продавца Строка (максимум 50 символов)
amount Сумма блокировки в минимальных единицах валюты (копейках) Целое число
add_card Параметр, задающий необходимость сохранения карты после оплаты. Используется вместе с параметром "type":"Pay". Значение по умолчанию false - карта не сохраняется true/false
type Тип создаваемой сессии.

  1. Pay - платежная сессия
  2. Add - сессия для сохранения карты
 Строка: "Pay"/"Add"
payment_type Тип оплаты.

  1. OneStep - одностадийная оплата. В случае одностадийной операции, в результате успеха деньги будут списаны с карты пользователя
  2. TwoStep - двухстадийная оплата
 Строка: "OneStep"/"TwoStep"
action Дополнительное действие с заблокированной суммой.

  1. Unblock - разблокировка. Доступно только для TwoStep
 Строка
recurrent Необходимо использовать в случае, если сохраняемая карта будет использоваться для рекуррентных списаний. Возможность использования необходимо уточнить дополнительно у support@mapcard.pro true/false
lifetime Срок действия сессии (в секундах), по истечении которого оплата по данной сессии будет невозможна. Если не передан, время жизни сессии устанавливается равным одной неделе Целое число
card_uid Идентификатор карты theMAP. Используется для платежа по сохраненной карте Строка
credential Объект
├─ login Логин держателя карты, зарегистрированного в системе Продавца. Используются только в случае, если карта сохранена к конкретному пользователю Строка (максимум 50 символов)
├─ password Пароль держателя карты, зарегистрированного в системе Продавца. Используются только в случае, если карта сохранена к конкретному пользователю Строка (максимум 50 символов)
├─ merchant_name Наименование продавца. Используются только в случае, если карта сохранена за Мерчантом Строка (максимум 50 символов)
├─ merchant_password Пароль Мерчанта для совершения операций. Используются только в случае, если карта сохранена за Мерчантом Строка (максимум 50 символов)
├─ terminal_password Пароль терминала для совершения операций. Строка (максимум 50 символов)
custom_params Дополнительные параметры платежа, для отображения на шаблоне и для составления адреса возврата пользователя в случае, если он параметризован.

Перечень возможных параметров:
  1. Email - адрес электронной почты клиента для отправки фискального чека
  2. successUrl - адрес для перенаправления Пользователя со страницы оплаты в случае успеха
  3. failUrl - адрес для перенаправления Пользователя со страницы оплаты в случае неуспеха
  4. Description - дополнительное описание заказа для отображения на форме оплаты
  5. PayButtonCustomText - текст для отражения на кнопке для инициирования оплаты на форме.

    Возможность использования данных параметров необходимо уточнить у support@mapcard.pro
 Объект формата {"param1":"test", "param2":"test"...}
split Используется для разделение суммы произведенного списания на составные части для последующих расчетов с контрагентами. Общая сумма всех составных частей должна соответствовать amount Массив
├─ split_terminal_id1 Номер терминала для проведения операции Число
├─ amount1 Сумма разделения Число
├─ purpose1 Описание Строка
├─ fee1 Размер комиссии Число

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

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

В зависимости от бизнес-сценария, карта может быть сохранена:

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