Параметры открытия платежной формы Payment Page

Параметры, необходимые для работы Payment Page, передаются в объекте configObj или списком (при открытии в отдельной вкладке). Список требуемых и дополнительных параметров зависит от выбранного режима работы Payment Page.

Подробнее о собираемых параметрах о пользователе см. в разделе Сбор данных о пользователе.

Внимание: Протокол открытия платежной формы Payment Page запрещает использование в прямом виде символа ";" (точка с запятой) в значениях передаваемых параметров и в строке запроса.
Табл. 1. Параметры вызова Payment Page
Параметр Обязательность Тип Описание Пример
account_token Нет string Токен банковской карты. При передаче токена в этом параметре виджет открывается с предвыбранной картой.
Ограничение: Применяется в режимах Purchase и Card Verify.

Дополнительные сведения см. в Проведение оплат по токенам

 
addendum_data Нет string

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

Расширенная информация должна представляться в параметре строкой, закодированной с применением алгоритма Base64. Подробнее о формировании значения параметра addendum_data см. Длинная запись в Payment Page

 
baseUrl Нет string Базовый адрес Payment Page, если по каким-либо причинам домен Payment Page не совпадает с доменом для подключения библиотек или merchant.js подключается не через тег <script>  
best_before Нет string Дата и время срока действия платежа. По истечении срока действия платежа пользователь перенаправляется на страницу с сообщением о том, что время возможности проведения платежа истекло. Параметр передается в формате YYYY-MM-DDThh:mm:ss±hh 2020-04-26T13:50:37+00:00
billing_address Настраивается string Улица платежного адреса пользователя Ленина ул., 20
billing_city Настраивается string Город платежного адреса пользователя Дубна
billing_country Настраивается string Страна платежного адреса пользователя в формате ISO 3166-1 alpha-2 RU
billing_postal Настраивается string Почтовый индекс платежного адреса пользователя 101000
billing_region Настраивается string Регион или штат платежного адреса пользователя Московская область
billing_region_code Нет string Код штата, провинции или региона страны в формате ISO 3166-2; при указании значения этого параметра также необходимо указать значение параметра billing_country MOS
card_holder Нет string Имя держателя карты, как указано на карте. При передаче параметра значение сразу отображается и доступно для редактирования на платежной форме CARD HOLDER
card_operation_type Нет string Тип операции в случае проведения оплаты с помощью банковской карты. Возможные значения:
  • sale: оплата с прямым списанием средств
  • auth: оплата с холдированием средств

Дополнительные сведения см. в Платежи с использованием платёжных карт

sale
cash_voucher_data Обязательно для Purchase, если деятельность регулируется по 54-ФЗ РФ string Строка, содержащая в закодированном виде единичные товарные позиции в чеке, необходимые для формирования фискального чека. Данные собираются в JSON-объект и кодируются сначала в Base64 и затем URL-encoded. Структура JSON-объекта приведена в API, модель CashVoucherData. Подробнее см. Работа с фискальными чеками РФ  
checkout_script Нет boolean Параметр, определяющий возможность проведения оплаты или проверки действительности карты по токену без ввода CVV с использованием скрипта шифрования. Подробнее см. в разделе Скрипт шифрования карточных данных 1
close_on_missclick Нет boolean

Параметр, определяющий поведение виджета, открытого в модальном окне, при щелчке за пределами области отображения виджета:

  • 0 — не закрывать виджет по щелчку за его пределами. Это значение по умолчанию.
  • 1 — закрыть виджет при щелчке мышью за его пределами.

Подробнее см. Открытие платежной страницы в модальном окне

1
css_modal_wrap Нет string Дополнительный CSS класс обертки для модального окна. Дополнительные сведения см. в Открытие платежной страницы в модальном окне modal-popup
customer_address Настраивается string Адрес пользователя. Подробнее см. в Сбор данных о пользователе Ленина ул., 2
customer_account_info Нет string Строка, полученная в результате кодирования с применением алгоритма Base64, с информацией об учётной записи пользователя на стороне веб-сервиса и о контактных данных пользователя. Подробнее см. в пункте Новый параметр customer_account_info раздела о форматах запросов при переходе к аутентификации 3‑D Secure 2  
customer_account_number Нет string Номер кошелька или аккаунта пользователя в платежной системе, также может быть номер телефона (указывается с кодом страны и без знака +) или адрес электронной почты пользователя, на который зарегистрирован аккаунт example@mail.com
customer_birthplace Настраивается string Место рождения пользователя Курск
customer_city Настраивается string Город адреса пользователя Курск
customer_country Настраивается string Страна адреса пользователя в формате ISO 3166-1 alpha-2 RU
customer_day_of_birth Настраивается string Дата рождения пользователя, ДД-ММ-ГГГГ 12-12-1990
customer_email Настраивается string Электронная почта пользователя smith@gmail.com
customer_first_name Настраивается string Имя пользователя Инна
customer_id Обязательно для Card Tokenize, Purchase string Уникальный идентификатор пользователя в вашем проекте
Внимание: Передаваемые в параметре или объекте customer данные собираются и отображаются в соответствующем разделе в Dashboard.
customer_341
customer_last_name Настраивается string Фамилия пользователя Малая
customer_middle_name Настраивается string Отчество пользователя Ивановна
customer_mpi_result Нет string Cтрока, полученная в результате кодирования с применением алгоритма Base64, с данными о предыдущей аутентификации пользователя. Подробнее см. в пункте Новый параметр customer_mpi_result раздела о форматах запросов при переходе к аутентификации 3‑D Secure 2  
customer_phone Настраивается string Телефон пользователя. Должен содержать от 4 до 24 цифр 74991234567
customer_security_code Нет string Секретный код счета или кошелька пользователя для подтверждения платежа 852923
customer_shipping Нет string Строка, полученная в результате кодирования с применением алгоритма Base64, с информацией о доставке товара или услуги пользователю. Подробнее см. в пункте Новый параметр customer_shipping раздела о форматах запросов при переходе к аутентификации 3‑D Secure 2  
customer_ssn Настраивается integer Последние 4 цифры номера социального страхования гражданина США 1234
customer_state Настраивается string Штат адреса пользователя Курская область
customer_street Нет string Улица адреса пользователя Ленина
customer_zip Настраивается string Почтовый индекс пользователя 305000
debt_account Нет string Номер счета для получения средств с карты пользователя с целью погашения задолженности. Допустимы буквы латинского алфавита и цифры, длина не более 10 символов an9876170i
descriptor Нет string Краткая информация, идентифицирующая мерчанта, который осуществил операцию. Максимальная длина — 13, допустимо использование букв латинского алфавита, цифр и следующих символов:# $ * ( ) - _ = + " ; : ? \ / , . ` ' ^ "Merchant_1"
force_acs_new_window Нет boolean Форсированный режим отображения страницы ACS в новом окне, игнорируя настройки Payment Page
  • 1: открытие в отдельной вкладке
  • параметр отсутствует: открытие заданным способом
1
force_payment_method Нет string Идентификатор платежного метода, который откроется по умолчанию без возможности выбора другого. Список идентификаторов приведен в Коды поддерживаемых платежных методов card
force_payment_method_subtype Нет string Идентификатор типа банковской карты, который откроется по умолчанию без возможности выбора другого, при force_payment_method=card. Также относится к отображению сохраненных карт пользователя. Доступные значения см. в Поддерживаемые типы платёжных карт visa
hide Нет string Идентификатор платежного метода, который будет скрыт от пользователя на Payment Page. Если необходимо скрыть несколько методов – идентификаторы передаются через запятую. Список идентификаторов приведен в Коды поддерживаемых платежных методов card, cup-card
identify_doc_number Нет string Номер документа, подтверждающего личность пользователя 6543234567
interface_type Нет string Строка, содержащая информацию об источнике запроса на проведение платежа. Данные собираются в JSON-объект. Доступное значение для параметра id: 7Payment Page в режиме iframe interface_type: {"id":7}
language_code Рекомендовано string Язык, на котором сгенерированная платежная страница будет открыта пользователю. Язык передается в формате ISO 639-1 alpha-2. Если этот параметр не передается, то по умолчанию платежная платформа определяет язык по IP-адресу пользователя ru
merchant_fail_enabled Нет integer Параметр, отвечающий за возможность возврата пользователя в проект при отклоненной оплате. Подробнее см. в разделе Способы возврата пользователя в проект после оплаты 1
merchant_fail_redirect_mode Нет string Режим открытия страницы проекта во время возврата пользователя в проект после отклоненного платежа. Подробнее см. в разделе Способы возврата пользователя в проект после оплаты iframe
merchant_fail_url Нет string URL-адрес страницы для возврата пользователя в проект при отклоненной оплате по нажатии на кнопку возврата. Подробнее см. в разделе Способы возврата пользователя в проект после оплаты http://example.com
merchant_return_enabled Нет integer Параметр, отвечающий за возможность возврата пользователя в проект на любом шаге оплаты по нажатии на кнопку возврата. Подробнее см. в разделе Способы возврата пользователя в проект после оплаты 1
merchant_return_redirect_mode Нет string Режим открытия страницы проекта во время возврата пользователя в проект на любом шаге оплаты по нажатии на кнопку возврата. Подробнее см. в разделе Способы возврата пользователя в проект после оплаты iframe
merchant_return_url Нет string URL-адрес страницы для возврата пользователя в проект на любом шаге оплаты по нажатии на кнопку возврата. Подробнее см. в разделе Способы возврата пользователя в проект после оплаты http://example.com
merchant_success_enabled Нет integer Параметр, отвечающий за возможность возврата пользователя в проект после совершенного платежа. Подробнее см. в разделе Способы возврата пользователя в проект после оплаты 1
merchant_success_redirect_mode Нет string Режим открытия страницы проекта во время возврата пользователя после совершенного платежа. Подробнее см. в разделе Способы возврата пользователя в проект после оплаты iframe
merchant_success_url Нет string URL-адрес страницы для возврата пользователя в проект при проведенной оплате по нажатии на кнопку возврата. Подробнее см. в разделе Способы возврата пользователя в проект после оплаты http://example.com
mode Обязательно для всех режимов, кроме Purchase string

Режим работы Payment Page. Доступные значения:

  • purchase: режим Purchase. Используется по умолчанию
  • card_tokenize: режим Card Tokenize
  • card_verify: режим Card Verify
card_tokenize
moto_type Нет integer Признак проведения Mail Order/Telephone Order (MO/TO) платежа. Доступные значения:
  • 1: оплата MO
  • 2: оплата TO
2
payment_amount Обязательно для Purchase, Card Verify integer Сумма платежа в дробных единицах валюты. Ограничения:
  • для режимов Purchase, Card Tokenize:
    • "minimum": 1,
    • "maximum": 10000000000000
  • для режима Card Verify:
    • "minimum": 0,
    • "maximum": 0
10000
payment_currency Обязательно для Purchase, Card Verify string Валюта платежа в формате ISO 4217 alpha-3 USD
payment_description Рекомендовано string Описание платежа Заказ 3178
payment_extra_param Нет string Параметр, содержащий особые условия обработки платежей. Дополнительные сведения об этой возможности уточняйте у вашего курирующего менеджера  
payment_id Обязательно для Purchase, Card Verify string Уникальный идентификатор платежа в вашем проекте Z4205
payment_merchant_risk Нет string Строка, полученная в результате кодирования с применением алгоритма Base64, с информацией о деталях покупки пользователя и о предпочтительном для мерчанта варианте аутентификации. Подробнее см. в пункте Новый параметр payment_merchant_risk раздела о форматах запросов при переходе к аутентификации 3‑D Secure 2  
payment_methods_options Нет string Строка, содержащая специфичные параметры отображения выбора платежного метода или платежной страницы. Данные собираются в JSON-объект.Подробнее см. в разделе Поддержка платёжных методов о проведении платежей через банки юго-восточной Азии  
project_id Да integer Уникальный идентификатор проекта в Payment Page 133
receipt_data Нет string Строка, содержащая в закодированном виде данные для отправки электронного товарного чека пользователю. Данные собираются в JSON-объект и кодируются в Base64. Подробнее см. в Отправка чеков и оповещений пользователю  
recurring Нет string Строка, содержащая в закодированном виде параметры регистрации и проведения COF-платежа. Данные собираются в JSON-объект и кодируются в URL-encoded. Структура JSON-объекта приведена в API, модель recurringinfo.

Подробнее см. в Проведение COF-платежей

 
recurring_register Нет boolean Параметр, который показывает, будет ли данный платеж зарегистрирован как рекуррентный 1
redirect Нет boolean

Параметр, включающий открытие сгенерированной платежной страницы в отдельной вкладке

  • 1: открытие в отдельной вкладке
  • не передан: открытие заданным способом

Подробнее см. в Открытие платежной страницы в отдельной вкладке браузера

1
redirect_fail_mode Нет string

Режим перенаправления пользователя при отклоненной оплате:

  • iframe. Используется по умолчанию
  • parent_page
  • blank_page. В браузере пользователя должна быть отключена блокировка всплывающих окон
parent_page
redirect_fail_url Нет string URL-адрес страницы для перенаправления пользователя в проект в случае отклоненной оплаты. Перенаправление происходит автоматически без дополнительных действий от пользователя. Если используется режим blank_page – страница с результатом отображается в отдельной вкладке, в других режимах – не отображается http://merchant.site.com
redirect_on_mobile Нет boolean

Параметр, включающий открытие платежной страницы в отдельной вкладке на мобильных устройствах

  • 1: открытие в отдельной вкладке
  • не передан: открытие заданным способом

Подробнее см. в Вызов платежной страницы командой

1
redirect_success_mode Нет string

Режим перенаправления пользователя при проведенной оплате:

  • iframe. Используется по умолчанию
  • parent_page
  • blank_page. В браузере пользователя должна быть отключена блокировка всплывающих окон
parent_page
redirect_success_url Нет string URL-адрес страницы для перенаправления пользователя в проект в случае проведенной оплаты. Перенаправление происходит автоматически без дополнительных действий от пользователя. Если используется режим blank_page – страница с результатом отображается в отдельной вкладке, в других режимах – не отображается http://merchant.site.com
redirect_return_url Нет string URL-адрес страницы для перенаправления пользователя в проект со страницы оплаты на стороне внешнего провайдера по нажатии на кнопку возврата на любом шаге проведения платежа. О возможности подключения данной функциональности уточняйте у курирующего менеджера http://merchant.site.com
redirect_tokenize_mode Нет string

Режим перенаправления пользователя при успешной токенизации в режиме Card Tokenize

  • iframe. Используется по умолчанию
  • parent_page
parent_page
redirect_tokenize_url Нет string URL-адрес страницы для перенаправления пользователя в ваш проект в случае успешной токенизации в режиме Card Tokenize  
region_code Нет string Страна пользователя в формате ISO 3166 alpha-2. По умолчанию определяется по IP-адресу пользователя ru
signature Да string Подпись, передаваемая в объекте или ссылке на открытие платежной страницы. Подробнее см. в Работа с подписью к данным  
target_element Нет string Элемент, в который встраивается iframe Payment Page в веб-странице проекта. Подробнее см. в Открытие платежной страницы, встроенной в веб-страницу pay_button_id
terminal_id Нет integer Уникальный идентификатор шаблона Payment Page, который требуется запустить, игнорируя региональные настройки и настройки A/B тестов 54