Выполняется с помощью команды Init. Метод используется в случае, если форма ввода данных банковской карты находится на стороне theMAP. При положительном результате вызова метода возвращается уникальный идентификатор, который позволяет в дальнейшем вызвать страницу оплаты, находящуюся на стороне theMAP, и перенаправить на нее пользователя для ввода данных карты.
При получении идентификатора сессии возможно указание цели использования платежной формы - для блокировки средств на карте или для сохранения карты в хранилище theMAP для последующих списаний. В случае сохранения карты последующие списания могут производиться как с вводом CVV2/CVC2, так и безакцептно – без ввода каких-либо данных и участия держателя карты. Это могут быть рекуррентные списания или классические транзакции без ввода CVV2/CVC2. В последнем случае возможны отказы из-за ограничений эмитента в связи с необходимостью применения технологии 3-D Secure.
Страница оплаты может быть оформлена в дизайне Продавца и не является уникальной (Продавец может иметь несколько страниц ввода данных для разных случаев).
| Название | Описание | Формат | Обязательный |
|---|---|---|---|
| Key | Идентификатор Продавца. Выдается Продавцу с параметрами тестового/боевого доступа | Строка | Да |
| Password | Пароль терминала. Выдается Продавцу с параметрами тестового/боевого доступа | Строка | Да |
| OrderId | Идентификатор платежа в системе Продавца | Строка (максимум 50 символов) | Нет |
| Amount | Сумма блокировки в минимальных единицах валюты (копейках) | Цифры, не содержащие десятичных или других разделителей | Нет |
| CustomParams | Дополнительные параметры платежа, для отображения на шаблоне и для составления адреса возврата пользователя в случае, если он параметризован | Cтрока, содержащая пары ключей и их значений команды, разделённые символом «;» (точка с запятой). Ключи и значения разделены символом «=» (равно). Перечень возможных параметров: Email - адрес электронной почты клиента для отправки фискального чека; successUrl - адрес для перенаправления Пользователя со страницы оплаты в случае успеха, failUrl - адрес для перенаправления Пользователя со страницы оплаты в случае неуспеха; Description - дополнительное описание заказа для отображения на форме оплаты; PayButtonCustomText - текст для отражения на кнопке для инициирования оплаты на форме. Возможность использования данных параметров необходимо уточнить у support@mapcard.pro | Нет |
| AddCard | Параметр, задающий необходимость сохранения карты после оплаты. Используется вместе с параметром Type=Pay. Значение параметра по умолчанию «False». «True» — карта сохраняется. «False» — карта не сохраняется | True/False | Нет |
| Type | Тип создаваемой сессии. Pay – создается платежная сессия. Add – создается сессия для сохранения карты | Pay/Add | Да |
| PaymentType | Параметр, задающий тип оплаты. OneStep – одностадийная. TwoStep - двухстадийная. В случае одностадийной операции, в результате успеха деньги будут списаны с карты пользователя | OneStep/TwoStep. Значение по-умолчанию - OneStep | Нет |
| Action | Дополнительное действие с заблокированной суммой. «Unblock» - разблокировка | Доступно только для TwoStep | Нет |
| Recurrent | Необходимо использовать в случае, если сохраняемая карта будет использоваться для рекуррентных списаний. Возможность использования необходимо уточнить дополнительно | true/false | Нет |
| Lifetime | Срок действия сессии, по истечении которого оплата по данной сессии будет невозможна. Если не передан, время жизни сессии устанавливается равным одной неделе | Число в секундах | Нет |
| Goods | Список наименований товаров/услуг для отправки в ОФД (54-ФЗ) | Cтрока, содержащая пары ключей и их значений команды, разделённые символом «;» (точка с запятой). Ключи и значения разделены символом «=» (равно). Общая сумма всех товаров должна соответствовать Amount. Длина одного наименования - не более 128 символов | Нет |
| CardUId* | Идентификатор карты. Используется для платежа по сохраненной карте | Строка (максимум 50 символов) | Нет |
| UserLogin* | Логин держателя карты, зарегистрированного в системе Продавца | Строка (максимум 50 символов) | Нет |
| UserPassword* | Пароль держателя карты, зарегистрированного в системе Продавца | Строка (максимум 50 символов | Нет |
| Merchant** | Наименование продавца | Строка (максимум 50 символов | Нет |
| MerchantPassword** | Пароль Мерчанта для совершения операций | Строка (максимум 50 символов | Нет |
| Split | Используется для разделение суммы произведенного списания на составные части для последующих расчетов с контрагентами | Строка, содержащая группы пар ключ-значение, где группы содержатся в фигурных скобках {}, пары ключ-значение разделены символом «,» (запятая). Ключ и значение разделены символом «:» (двоеточие). Строка обособляется прямоугольными скобками «[]». Параметры ключей и значений выдаются Продавцу с параметрами тестового/боевого доступа. Общая сумма всех составных частей должна соответствовать Amount | Нет |
* - используются только в случае, если карта сохранена/сохраняется за Пользователем
** - используются только в случае, если карта сохранена за Мерчантом
Для сохранения/оплаты по сохраненной карте за терминалом, эти параметры передавать не нужно
В зависимости от бизнес-сценария, карта может быть сохранена:
Формат параметра Goods
Товар=Цена,Признак предмета расчета,Ставка НДС,Признак способа расчета|{Данные поставщика}
| Название | Описание | Формат |
|---|---|---|
| Цена | Сумма блокировки в минимальных единицах валюты (копейках) | Цифры, не содержащие десятичных или других разделителей |
| Признак предмета расчета | 1 – Товар, 2 – Подакцизный товар, 3 – Работа, 4 – Услуга, 5 – Ставка азартной игры, 6 – Выигрыш азартной игры, 7 – Лотерейный билет, 8 – Выигрыш лотереи, 9 – Предоставление РИД, 10 - Платеж, 11 – Агентское вознаграждение, 12 – Составной предмет расчета, 13 – Иной предмет расчета | Число от 1 до 13. Параметр не обязательный. Значение по-умолчанию 1 – Товар |
| Ставка НДС | 1 – ставка НДС 20%, 2 – ставка НДС 10%, 3 – ставка НДС расч. 20/120, 4 – ставка НДС расч. 10/110, 5 – ставка НДС 0%, 6 – НДС не облагается | Число от 1 до 6. Параметр не обязательный. В случае отсутствия в запросе, значение берется из настроек терминала |
| Признак способа расчета | 1 – Предоплата 100%, 2 – Частичная предоплата, 3 – Аванс, 4 – Полный расчет, 5 – Частичный расчет и кредит, 6 – Передача в кредит, 7 – оплата кредита | Число от 1 до 7. Параметр не обязательный. В случае отсутствия в запросе, будет передано значение 4 – Полный расчет |
| Данные поставщика | "name" - Наименование, "phoneNumbers" - список номеров телефонов, "supplierINN" - ИНН поставщика | Строка JSON. Параметр не обязательный |
Пример передачи Goods
Услуга=100,4,1,3|{"name": "ООО Ромашка", "phoneNumbers": ["+71111111111"],"supplierINN": "77777777"};Товар=810,1|{"name": "ООО Кармашка", "phoneNumbers": ["+71111114859"],"supplierINN": "777757777"};Услуга2=20,4;Товар2=30