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

Введение

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

Рис.: Проведение платежей через основные интерфейсы платформы

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

Ключевые понятия: проекты и платежи

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

Количество проектов для одного мерчанта может быть разным. Зачастую для работы вполне достаточно одного проекта, но в каких-то случаях их число может расти. Как правило, оптимальное количество определяется специалистами ecommpay, исходя из специфики мерчанта и его задач. И, что важно, это число может пересматриваться в процессе сотрудничества.

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

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

Инструменты для работы: интерфейсы и компоненты

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

Payment Page — платёжная форма ecommpay, которая вызывается через программный интерфейс (API) и позволяет проводить оплаты и выполнять другие действия с применением различных платёжных методов.
Gate — платёжный программный интерфейс (API), который обеспечивает максимальные возможности в работе с платежами всех поддерживаемых типов и методов и подразумевает при этом использование на стороне веб-сервиса собственных решений мерчанта в части пользовательского интерфейса (UI).
Dashboard — веб-интерфейс для сотрудников мерчанта, позволяющий настраивать различные параметры работы по проектам, и в том числе интерфейс платёжной формы Payment Page, а также контролировать состояние всех проводимых платежей, управлять их проведением и инициировать различные платежи и операции.
Telegram-бот технической поддержки ecommpay — дополнение к интерфейсу Dashboard, позволяющее получать информацию о платежах, в том числе с рекомендациями по дальнейшим действиям при отклонении платежей, и передавать вопросы специалистам ecommpay через сервис Telegram.
Data API — программный интерфейс (API), позволяющий получать информацию об операциях, опротестованиях и балансах по используемым проектам и выстраивать сводный контроль и анализ проведения платежей за рамками интерфейса Dashboard (например, в сторонней аналитической системе).

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

SDK для мобильных приложений — наборы средств разработки (SDK) для подключения к платформе мобильных приложений, работающих с операционными системами iOS и Android, с использованием специальной версии платёжной формы Payment Page или собственного пользовательского интерфейса.
Интеграционные модули для CMS — плагины (в терминологии отдельных систем также „картриджи“) для подключения к платформе веб-сервисов, созданных на базе ряда распространённых систем управления содержимым (CMS) и профильных платформ электронной коммерции.
SDK для работы с подписью — наборы средств разработки (SDK) на разных языках программирования, позволяющие подписывать отправляемые данные и проверять корректность получаемых данных при программном взаимодействии с платформой.

Наконец, отдельным компонентом может считаться платёжный Telegram-бот ecommpay — специализированный бот, встроенный в сервис Telegram и позволяющий проводить платежи через взаимодействие бота мерчанта с этим сервисом и использование платёжной формы ecommpay.

Вместе все эти средства составляют множество инструментов для работы с платформой со стороны мерчанта, и в разных случаях можно строить работу с использованием различного числа инструментов. Так, в каких-то ситуациях для решения всех задач может быть достаточно одного интерфейса Dashboard, а в каких-то может быть актуально использовать SDK для мобильных приложений и для работы с подписью, Payment Page, Gate, Dashboard и Data API. Как правило, ключевыми факторами для выбора тех или иных инструментов являются целевые типы платежей и пользовательских сценариев, способы разработки веб-сервиса и интересующие способы организации работы с платформой. С учётом этих факторов построен, в частности, и навигатор по настоящей документации, доступный на её стартовой странице. И с учётом этих же факторов может выполняться подбор оптимальных решений с участием специалистов ecommpay.

Возможности и процедуры

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

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

К этому можно также добавить, что технически за поддержкой любой возможности стоит выполнение определённых процедур, и при работе с разными инструментами эти процедуры в той или иной мере могут касаться веб-сервиса, конечных пользователей или специалистов мерчанта. Например, аутентификация пользователя с применением протокола 3‑D Secure, используемая для проведения оплат, при работе с платёжными интерфейсами ecommpay не требует участия веб-сервиса (только действий пользователя), а при работе через Gate требует от веб-сервиса целого ряда действий (по приёму и обработке данных и перенаправлениям пользователя). Такие нюансы, связанные со спецификой различных инструментов и возможностей, тоже всегда полезно иметь в виду.

Функционально возможности платформы можно разбить на несколько групп. Это:

Проведение платежей разных типов (или выполнение основных платёжных процедур) — группа возможностей, обеспечивающих базовые функции платформы.
Эти возможности принципиально позволяют проводить оплаты разных типов (в одну и две стадии, разово и с различными видами повторений), а также выплаты и „условные“ платежи для проверки действительности платёжных инструментов и использовать при этом различные платёжные методы.
Выполнение вспомогательных платёжных процедур — группа возможностей, обеспечивающих соблюдение требований, которые могут предъявляться при проведении платежей в отдельных случаях.
Эти возможности позволяют выполнять такие процедуры, которые не обязательны для всех случаев, но обязательны для некоторых — в соответствии с требованиями платёжных систем, региональной спецификой и другими условиями. Как правило, это относится к необходимости дополнительного подтверждения подлинности пользователей, и примерами таких процедур можно считать аутентификацию 3‑D Secure и проверку Address Verification Service.
Расширение платёжных сценариев (или использование дополнительных возможностей) — группа возможностей, обеспечивающих подстройку под различные ситуации и потребности для улучшения платёжных сервисов.
Эти возможности позволяют выполнять такие процедуры, которые можно назвать полезными дополнениями: они не обязательны для проведения платежей, но способствуют тому, чтобы повышать вариативность платёжных сценариев, конверсию платёжных интерфейсов, проходимость платежей, уровень защиты от мошенничества и лояльность пользователей.
Обеспечение функций управления платёжными решениями и средствами — группа возможностей, покрывающих те потребности мерчантов, которые связаны с управлением платёжными решениями, но не касаются непосредственного проведения платежей.
Эти возможности позволяют обеспечивать и облегчать такие процедуры, которые касаются контроля и анализа информации о платежах, работы с опротестованиями платежей, управления балансовыми средствами и прочих подобных процессов, необходимых в работе мерчантов.

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

Порядок подключения

В зависимости от того, какие инструменты планируется использовать для работы с платформой, состав и порядок выполнения подготовительных технических работ могут существенно отличаться. В общем случае для этого необходимо:

Решить организационные вопросы, касающиеся взаимодействия с ecommpay:
1. Если организация ещё не является клиентом ecommpay и у неё нет идентификаторов проектов и секретных ключей для взаимодействия с платёжной платформой — отправить заявку на подключение и получить начальное одобрение этой заявки и контактные данные специалистов ecommpay, курирующих подключение.
2. Если планируется проводить платежи с использованием карт платёжных систем Visa или Mastercard — предоставить курирующему менеджеру ecommpay документы о соответствии требованиям PCI DSS:
  - Для всех мерчантов — отчёт о результатах ASV-сканирования.
    Такие сканирования должны выполняться авторизованными поставщиками (PCI SSC Approved Scanning Vendor, ASV) ежеквартально, а также после каждого значительного изменения сетевой инфраструктуры. Мерчанты ecommpay могут выбирать таких поставщиков самостоятельно и, если это актуально, могут задействовать поставщика, являющегося партнёром ecommpay. Чтобы организовать сканирования через партнёра ecommpay, можно обращаться к курирующему менеджеру.
  - Для мерчантов с количеством операций более 6 миллионов в год (уровня 1) — аттестат соответствия (Attestation of Compliance, AOC).
  - Для мерчантов с количеством операций до 6 миллионов в год (уровней 2, 3 и 4) — опросный лист (Self-Assessment Questionnaire, SAQ).
    С вопросами о правилах заполнения опросных листов можно обращаться к курирующему менеджеру ecommpay.
3. Если необходима техническая интеграция — согласовать со специалистами технической поддержки ecommpay порядок и сроки интеграции, тестирования и запуска в работу. В рамках согласования порядка тестирования могут быть согласованы возможности проведения тестовых платежей с использованием платёжных карт, а также некоторых из альтернативных платёжных методов.
Выполнить подготовительные технические работы, самостоятельно или с использованием специализированных компонентов, предоставляемых ecommpay, если это актуально; в том числе обеспечить подписывание данных и корректное реагирование на оповещения на стороне серверной части веб-сервиса.
Совместно со специалистами технической поддержки ecommpay протестировать выполнение целевых действий и запустить решение по взаимодействию веб-сервиса с платёжной платформой в работу.

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

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