Фильтрация платёжных методов

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

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

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

Рис. 1. Возможные ситуации с выбором платёжного метода: в типовом случае, при обилии подключённых методов и при фильтрации методов


Для гибкой адаптации к различным ситуациям в платформе предусмотрены разные способы фильтрации методов. Это:

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

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

Чтобы избегать таких проблем и эффективно применять фильтрацию там, где она действительно уместна (например, при работе в некоторых специфичных регионах или при использовании специфических сценариев работы), следует обсуждать актуальные задачи и способы фильтрации с курирующим менеджером ecommpay и внимательно анализировать предпочтения и затруднения своих пользователей. Также в некоторых случаях вместе с фильтрацией платёжных методов или даже вместо неё может быть эффективным настроить их ранжирование.

Директивная фильтрация

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

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

Рис. 2. Возможные ситуации с выбором платёжного метода: без фильтрации и с фильтрацией


Вместе с тем, когда для проведения платежа актуален только один платёжный метод или платёжные методы одной группы, может быть уместнее использовать возможность предварительного выбора соответствующих метода или группы (подробнее).

Использование

Чтобы директивно скрыть определённые методы в рамках конкретного сеанса работы Payment Page, в запросе на открытие Payment Page необходимо передать параметр hide с кодами этих методов (согласно справочнику) и с использованием запятой в качестве разделителя, если это актуально. При этом используются те же коды, что и для предварительного выбора методов, однако это не относится к кодам для предварительного выбора групп методов: скрывать группы методов допускается лишь через указание каждого из этих методов, но не через указание группы. В следующем примере из числа доступных для проведения платежа исключаются методы WeChat и Alipay.

Никаких дополнительных действий для подключения и использования директивной фильтрации не требуется.

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

{
   "project_id": 43,
   "payment_id": "456790",
   "payment_currency": "USD",
   "payment_amount": 131970,
   "customer_id": "customer_12", 
   "hide": "wechat, alipay",   // коды скрываемых платёжных методов
   "signature": "TSzdE5rJZaA9TYAKoGpfXriFf82MxF..."
 }

Параметрическая фильтрация

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

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

Так, если в рамках используемого проекта настроена фильтрация по валюте и в общем случае доступны классические карточные платежи, методы Blik, Open Banking in the UK и Open Banking in Germany, а в запросе на открытие Payment Page указан польский злотый (PLN), то пользователю будут доступны для выбора только карточные платежи и метод Blik.

Рис. 3. Возможные ситуации с выбором платёжного метода: без фильтрации и с фильтрацией


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

Подключение

Чтобы подключить параметрическую фильтрацию, со стороны мерчанта следует:

  1. Определить: для каких проектов актуален такой способ фильтрации, что следует использовать в качестве параметра фильтрации (страну пользователя или валюту платежа) и есть ли потребности в настройке исключений и особых правил фильтрации для отдельных методов.

    При необходимости на этом шаге можно консультироваться с курирующим менеджером ecommpay.

  2. Передать специалистам технической поддержки ecommpay информацию потребностях в настройке параметрической фильтрации и согласовать с ними сроки подключения и потребности в тестировании этой функциональности.
  3. Получить от специалистов ecommpay уведомление о подключении запрошенной функциональности и, при необходимости, проверить работу платёжной формы с её использованием.

Использование

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

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

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

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