Платежная форма 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
GooglePay Флаг отображения кнопки Google Pay {{.IsGooglePayEnabled}} false
GatewayMerchantID Параметр gatewayMerchantId выдается саппортом theMAP {{.GatewayMerchantID}} false
ShowOrderId Показать/скрыть номер заказа Boolean true
ShowDescription Показать/скрыть описание заказа, переданное в CustomParams Boolean true
ShowAmount Показать/скрыть сумму заказа Boolean true
ShowCVV Показать/скрыть поле CVV, если есть соответствующая настройка в терминале Boolean true

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

Название Описание Формат По-умолчанию
RedirectUrl Адрес возврата пользователя. Передается при инициализации сессии (или терминал). Обязательный параметр {{.RedirectUrl}}
State Тип страницы String Result
Result Результат проведения оплаты. Обязательный параметр {{.Success}}
RedirectDelay Задержка в миллисекундах до перенаправления пользователя на страницу возврата Number 1000
ResultText Текст результата оплаты Object {success: "Оплата прошла успешно",
fail: "Ошибка оплаты"}

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

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

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

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

или если на Init в СustomParams указан PayButtonCustomText (Например, PayButtonCustomText=Активировать Промокод)

{
    // ...
    ButtonText: {
        Pay: "{{index .CustomParams "PayButtonCustomText"}}",
    }
    // ...
}

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

{{index .CustomParams "Test"}}

Внимание! При оплате с помощью Google Pay с формы оплаты в iframe, в него необходимо добавить разрешение allowpaymentrequest.

<iframe allowpaymentrequest src="...">