Платежная форма theMAP

Данное руководство описывает работу с шаблонами, предназначенными для ввода данных платежной карты на стороне шлюза. Мы постарались создать гибкий инструмент, который позволит вам быстро создавать собственные сценарии оплаты.

Внимание! Шаблоны не должны содержать ссылок на сторонние ресурсы. Если вы хотите добавить свои собственные скрипты, изображения или стили, вы должны отправить их в нашу службу поддержки на support@mapcard.pro.

Шаблон дефолтной формы оплаты состоит из двух файлов:

  • index.html (страница ввода карточных данных)
  • result.html (страница результата оплаты)

В каждом файле вставлен скрипт с настройками шаблона. Основные параметры вставляются на шаблон с помощью компилятора шаблона. Их значение подставляются из передаваемых параметров при инициализации платежной сессии или настроек терминала. Все параметры чувствительны к регистру.

Настройки шаблона формы

Название Описание Формат По-умолчанию
Secret Ключ сессии. Обязательный параметр. {{.Secret}}
Amount Сумма платежа. Передается при инициализации платежной сессии {{. Amount}}
Currency Валюта терминала. Берется из настроек терминала {{.Currency}} RUB
SessionType Тип сессии. Pay – платежная сессия. Add – привязка карты {{.SessionType}} Pay
AllowNewCard Возможность оплаты по новой карте, в случае если имеются привязанные карты {{.AllowNewCard}} true
IsReceipt Включает поле email, если терминал поддерживает передачу данных на фискализацию в соответствии с 54-ФЗ {{.IsReceipt}} false
Email Email, который был передан при инициализации сессии в CustomParams. Подставляется в поле email {{.Email}}
HasUserCred Определяет авторизована ли сессия при инициализации по пользователю/покупателю. {{.HasUserCred}} false
AddCard Параметр, задающий необходимость сохранения карты после оплаты. Значение берется из передаваемого значения AddCard при инициализации сессии {{.AddCard}} false
ShowOrderId Показать/скрыть номер заказа true/false true
ShowDescription Показать/скрыть описание заказа, переданное в CustomParams true/false true
ShowAmount Показать/скрыть сумму заказа true/false true
ShowCVV Показать/скрыть поле CVV, если есть соответствующая настройка в терминале true/false true

Настройки шаблона результата оплаты

Название Описание Формат
RedirectUrl Адрес возврата пользователя. Передается при инициализации сессии (или терминал). Обязательный параметр {{.RedirectUrl}}
Result Результат проведения оплаты. Обязательный параметр {{.Success}}

Вы можете сделать шаблон оплаты без ввода владельца карты. В этом случае, в настройках шаблона необходимо добавить ключ Holder и задать строку с заглушкой для передачи данных в процессинг. Строка должна содержать не менее трех латинских символов.

{
    ...
    Holder: "Mr Cardholder",
    ...
}

Вы можете поменять текст на кнопке, для этого необходимо передать параметр ButtonText с текстом для типа сессии

{
    ...
    ButtonText: {
        Pay: "Оплатить",
        Add: "Добавить карту"
    }
    ...
}

Для отображения на шаблоне оплаты дополнительных параметров, переданных при инициализации платежной сессии, необходимо указать в кавычках имя параметра.

{{index .CustomParams "Test"}}