Предварительный выбор платёжных методов

Общая информация

По умолчанию работа пользователя с Payment Page начинается со страницы выбора платёжного метода, но в некоторых случаях нет необходимости отображать эту страницу. Например, когда пользователь выбирает метод в веб-сервисе мерчанта до открытия Payment Page или когда со стороны мерчанта по каким-либо причинам (с учётом специфики региона, пользователя или иных факторов) актуально использовать конкретный платёжный метод.

Для работы с такими ситуациями вВ платёжной платформе Benker предусмотрена возможность открытия Payment Page с учётом предварительно выбранного (пользователем или мерчантом) метода, минуя выбор метода в платёжной форме. Выбранный метод в таких случаях указывается в запросе на открытие Payment Page, и для подключения этой возможности не требуется никаких дополнительных действий.

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

Особенности

При работе с предварительным выбором платёжных методов необходимо учитывать следующие особенности:

  • в качестве предварительно выбранного может указываться один из методов, доступных в рамках используемого проекта, иначе запрос отклоняется;
  • пользователю не предоставляется возможность выбрать другой метод, кроме указанного при вызове Payment Page, в том числе и при выполнении всех повторных попыток в рамках платежа.

Формат запросов

Для указания платёжного метода в запросе на открытие Payment Page необходимо передавать код этого метода в параметре force_payment_method. Коды поддерживаемых методов представлены в отдельном справочнике.

Чтобы указать предпочтительную платёжную систему для оплаты с прямым использованием карты, в запросе на открытие Payment Page необходимо указать код платёжного метода card в параметре force_payment_method и идентификатор платёжной системы в параметре force_payment_method_subtype. Используемые идентификаторы платёжных систем представлены в отдельном справочнике.

В следующем примере в качестве предпочтительной указана платёжная система Mastercard.

{
   "project_id": 43,
   "payment_id": "456790",
   "payment_currency": "USD",
   "payment_amount": 131970,
   "customer_id": "customer_12", 
   "force_payment_method": "card",  // код платёжного метода
   "force_payment_method_subtype": "mastercard",   // идентификатор платёжной системы
   "signature": "TSzdE5rJZaA9TYAKoGpfXriFf82MxF..."
 }
Рис. 1. Пример данных из запроса с указанием платёжной системы Mastercard
{
   "project_id": 43,
   "payment_id": "456790",
   "payment_currency": "USD",
   "payment_amount": 131970,
   "customer_id": "customer_12", 
   "force_payment_method": "card",  // код платёжного метода
   "force_payment_method_subtype": "mastercard",   // идентификатор платёжной системы
   "signature": "TSzdE5rJZaA9TYAKoGpfXriFf82MxF..."
 }

Дополнительные материалы

При работе с предварительным выбором платёжных методов могут быть полезны следующие материалы: