Платежи WooCommerce в Армении, шаг за шагом с плагином Paynet

Если ваш магазин работает на WooCommerce, для приема армянских платежей разработчик не нужен. Плагин Paynet опубликован на WordPress.org, подключается к вашему аккаунту одним кликом и выводит перед покупателями каждый включенный вами процессор как отдельный вариант оплаты. Это весь путь, от пустого экрана плагинов до реального заказа, с указанием мест, где обычно что-то идет не так.

Перед началом

Три вещи стоит подготовить заранее:

• Магазин WooCommerce с ценами в AMD. Шлюз принимает только армянские драмы и намеренно отказывает в оплате при любой другой валюте магазина, чтобы заказ никогда не мог быть недосчитан из-за несовпадения валют.
• Магазин, соответствующий требованиям плагина: WordPress 6.0 или новее, WooCommerce 7.0 или новее, PHP 7.4 или новее. Поддерживаются как High-Performance Order Storage, так и блоки корзины и оформления заказа, так что выбирать между современным стеком и этим шлюзом не придется.
• Реквизиты ваших провайдеров или намерение их получить. Вы держите собственные договоры с каждым банком и кошельком, и реквизиты вводятся в ваш аккаунт Paynet. Для установки плагина они не нужны, только для приема реального платежа.

Шаг 1: установка плагина

Плагин опубликован на WordPress.org как DigitalBrains Payment Gateway for Paynet.am, текущая версия 1.6.12.

В админке WordPress перейдите в "Плагины" > "Добавить новый", найдите Paynet и установите его из каталога. Если вы предпочитаете установить ZIP-архив вручную, скачайте его со страницы плагинов и используйте "Плагины" > "Добавить новый" > "Загрузить плагин". В обоих случаях после этого активируйте его на экране плагинов.

Одно замечание об обновлениях: плагин сообщает на странице настроек, когда доступна новая версия, и дает ссылку для скачивания, но ничего никогда не устанавливается в ваш магазин без вашего запроса.

Шаг 2: подключение одним кликом

Перейдите в "WooCommerce" > "Настройки" > "Платежи" > "Paynet" и нажмите Connect.

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

В этом клике произошли две полезные вещи:

• Ваш домен верифицируется автоматически. Не нужно добавлять DNS-запись, не нужно загружать файл. Покупатели могут платить только на верифицированном домене, и подключение делает это за вас.
• API-ключи вводить не пришлось. Плагин аутентифицируется с помощью токена подключения, привязанного именно к этому магазину, так что в вашей базе данных WordPress не хранится секретный ключ, который мог бы утечь.

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

Шаг 3: добавление провайдеров и включение способов оплаты

Плагин показывает способы оплаты, которые предлагает ваш аккаунт Paynet. Если этот список пуст, страница настроек теперь объясняет почему, требуется ли аккаунту еще платежный провайдер или верифицированный домен, и дает ссылку в один клик прямо на нужный экран.

Чтобы заполнить список, откройте панель управления Paynet и добавьте провайдеров, с которыми у вас есть договор:

• ARCA и банки-участники (Ameriabank, Inecobank, Evocabank, Converse Bank, AraratBank, ACBA, IDBank, Ardshinbank и другие), с именем пользователя API и паролем, выданными вашим банком.
• Idram, с его EDP Account ID и секретным ключом.
• Telcell, с его Shop ID и Shop Key.

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

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

Шаг 4: тестирование через sandbox

Не делайте свой первый реальный платеж первым платежом вообще. Добавьте провайдера Sandbox в панели управления Paynet, и он появится на странице оплаты WooCommerce, как любой другой способ, так что вы можете пройти настоящий заказ витрины от корзины до страницы благодарности. Ни один банк или кошелек не задействуется, деньги не перемещаются, ничего не выставляется в счет и не засчитывается.

На тестовой странице оплаты номер карты определяет результат:

• 4111 1111 1111 1111 одобрен
• 4000 0000 0000 0002 отклонен эмитентом
• 4000 0000 0000 0069 недостаточно средств
• 4000 0000 0000 0101 ошибка 3-D Secure
• 4000 0000 0000 0119 тайм-аут процессора
• 4000 0000 0000 0259 истек срок транзакции

Любой другой 16-значный номер одобряется, а срок действия, CVV и имя держателя карты не проверяются. Тестовые платежи отображаются на вкладке "Тест" в вашей панели управления.

Прогоните как минимум эти четыре сценария:

1. Успешный заказ. Он должен достичь статуса оплаченного в WooCommerce без вашего вмешательства.
2. Отклоненный заказ. Покупатель должен увидеть понятное сообщение и иметь возможность попробовать снова.
3. Заброшенный платеж. Закройте страницу оплаты вместо того, чтобы платить. Покупатель возвращается на страницу оплаты заказа, заказ сохраняет свои позиции, и его можно оплатить снова.
4. Медленный платеж. Полезен из-за того, что делает с ним плагин, разбирается ниже.

Шаг 5: как плагин обрабатывает статус заказа

Это та часть, которую стоит понять, даже если вы больше никогда не прочитаете ни строчки о платежах, поскольку именно она останавливает и мошенничество, и потерю продаж.

Webhook - это только подсказка. Когда Paynet уведомляет магазин о том, что что-то произошло, плагин не верит сообщению на слово. Он обращается обратно к вашему аккаунту Paynet, аутентифицируясь токеном подключения магазина, и запрашивает достоверный статус платежа. Затем он сверяет оплаченную сумму и валюту с заказом, прежде чем завершить его. Поддельное уведомление не может отметить заказ оплаченным, поскольку самому уведомлению изначально ничего не доверяется.

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

Запоздалый платеж завершает заказ, а не оставляет его подвешенным. Если платеж подтвержден после закрытия окна оформления заказа, заказ завершается, а не остается отмененным и невыполненным. Именно для этого случая стоит проводить тест с медленным платежом из шага 4: это именно та ситуация, в которой магазин с наивной интеграцией ничего не отгружает, хотя банк уже забрал деньги.

Шаг 6: запуск

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

Когда вы запускаетесь, сделайте первый такой заказ сами, на небольшую сумму. Платежи до 500 драм бесплатны, а сверх этого Paynet взимает 20 драм за завершенный реальный платеж без ежемесячной платы и без процентов. Каждый новый аккаунт начинает с 200 бесплатных транзакций и 500 бесплатных чеков, и предоплаченные единицы никогда не сгорают. Подробности - на странице тарифов.

Возвраты и фискальные чеки

Две вещи вы получаете без дополнительной работы:

• Возвраты прямо с экрана заказа WooCommerce, полные или частичные. Paynet обрабатывает возврат, а результат отмечается в заказе. Возвраты ничего не стоят на стороне Paynet.
• Фискальные чеки e-HDM, если e-HDM настроен в вашем аккаунте Paynet. QR-код чека показывается покупателю на странице благодарности, а ссылка на чек прикрепляется к заметкам заказа. Чеки для платежей, прошедших через Paynet, бесплатны. Дополнительные сборы, например плата за наложенный платеж, отображаются в чеке отдельной строкой.

Что делать дальше

• Установите DigitalBrains Payment Gateway for Paynet.am с WordPress.org и нажмите Connect.
• Добавьте своих провайдеров в панели управления Paynet и подключите их к домену своего магазина.
• Добавьте провайдера Sandbox и прогоните описанные выше четыре тестовых сценария, включая заброшенный и медленный платеж.
• Начните верификацию бизнеса, а также настройку e-HDM, если вы этого еще не сделали, чтобы реальные платежи и чеки были готовы вместе.
• Сделайте один небольшой реальный заказ сами, прежде чем о чем-либо объявлять.
• Если какой-то шаг ведет себя не так, как описано, напишите на [email protected], указав домен своего магазина, а если у вас несколько магазинов, посмотрите страницу плагинов для других платформ.

WooCommerce, WordPress, ARCA, Idram, Telcell и названия банков выше являются товарными знаками своих владельцев. Paynet - независимый платежный шлюз, которым управляет ООО Digital Brains в Ереване; продавцы заключают собственные договоры с каждым провайдером.