# Предварительный выбор платёжных методов {#ru_PP__PreselectingPS .concept}

статья о возможности задавать конкретный платёжный метод при вызове платёжной формы

## Общая информация {#section_cf5_jxk_ymb .section}

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

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

![](images/ecommpay/ru_pp_preselectingps_1.svg "Базовый сценарий — с выбором метода в платёжной форме")

![](images/ecommpay/ru_pp_preselectingps_2.svg "Дополненный сценарий — с выбором метода до открытия платёжной формы")

Вместе с выбором метода в некоторых случаяхмогут использоваться и другие возможности, актуальные для конкретного метода ивлияющие на сценарии работы Payment Page. К таким возможностям, в частности, относятся:

-   *Отображение сохранённых данных определённой платёжной системы.* Для оплаты с прямым использованием карт можно ограничивать выбор карт, данные которых были сохранены пользователем. В таком случае в запросе на открытие Payment Page указывается идентификатор предпочтительной платёжной системы \(например, Mastercard или Visa\), в результате чего первой пользователю отображается страница выбора платёжной карты с данными карт указанной платёжной системы. Если таких данных нет или среди представленных карт нет подходящих, то пользователь может указать данные другой карты, в том числе другой платёжной системы.

    ![](images/ecommpay/ru_pp_preselectingps_3.svg)

-   *Предварительный выбор банка*. Для некоторых методов интернет-банкинга, например [Indonesian Online Banking](pm_indonesia.md#), предварительно можно указывать конкретный банк, поддерживающий оплату с использованием этого метода. В таком случае перенаправление пользователя осуществляется напрямую на сайт банка, минуя страницы с выбором платёжного метода и выбором банка.Информация о таких возможностях, специфичных для отдельных методов, представлена в описании этих методов в разделе [Методы](ru_pm_about.md).
-   *Предварительный выбор группы методов*. Некоторые методы, например [Open Banking in Germany](pm_germany.md#), входят в группы, идентификаторы которых можно указывать при отправке запроса на открытие Payment Page. В таком случае пользователю отображаются кнопки выбора только тех методов, которые входят в указанную группу и доступны в рамках используемого проекта.

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

## Особенности {#section_h5k_t1n_b4b .section}

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

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

## Формат запросов {#section_a4b_vxk_ymb .section}

Для указания платёжного метода в запросе на открытие Payment Page необходимо передавать код этого метода в параметре `force_payment_method`, для указания группы методов — код этой группы в параметре `force_payment_group`. Коды поддерживаемых методови групп представлены [в отдельном справочнике](ru_pm_codes.md).

В следующем примере для проведения оплаты указан метод Alipay.

``` { .language-json .show_more}

{
   "project_id": 42,
   "payment_id": "456789",
   "payment_currency": "USD",
   "payment_amount": 131970,
   "customer_id": "customer_12",
   "force_payment_method": "alipay",  // код платёжного метода
   "signature": "TSzdE5rJZaA9TYAKoGpfXriFf82MxF..."
 }

```

```language-json

{
   "project_id": 42,
   "payment_id": "456789",
   "payment_currency": "USD",
   "payment_amount": 131970,
   "customer_id": "customer_12",
   "force_payment_method": "alipay",  // код платёжного метода
   "signature": "TSzdE5rJZaA9TYAKoGpfXriFf82MxF..."
 }

```

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

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

``` { .language-json .show_more}

{
   "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..."
 }

```

```language-json
{
   "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..."
 }

```

## Дополнительные материалы {#section_dr1_mc2_hpb .section}

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

-   [Коды платёжных методов](ru_pm_codes.md)— справочный раздел с кодами поддерживаемых платёжных методов.
-   [Коды брендов платёжных карт](ru_card_codes.md)— справочный раздел с идентификаторами поддерживаемых платёжных систем.
-   [Фильтрация платёжных методов](ru_pp_methods_availability.md#)— раздел с информацией об ограничении списка платёжных методов для конкретного платежа.
-   [Методы](ru_pm_about.md)— раздел с информацией о платёжных методах и работе с ними.
-   [Спецификация Payment Page API](ru_PP_Parameters.md)— раздел с описанием параметров вызова Payment Page.

**На уровень выше:**[Вспомогательные процедуры и дополнительные возможности](ru_PP_Additional.md)