Платежи OpenCart в Армении: установка, подключение, запуск

Магазину на OpenCart в Армении обычно нужны одни и те же три способа оплаты: банковские карты, Idram и Telcell. Подключение каждого по отдельности означает отдельный договор, отдельную интеграцию и отдельный набор обратных вызовов для поддержки. Расширение Paynet для OpenCart заменяет это одной установкой и одним кликом подключения, а затем позволяет включать и выключать способы оплаты из панели управления Paynet, больше не трогая сам магазин.

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

Одно расширение, три поколения OpenCart

Paynet публикует отдельную сборку для каждого поколения OpenCart, поскольку система расширений менялась между ними. Все три бесплатны и ведут себя одинаково после установки.

• OpenCart 2: для магазинов на OpenCart 2.3.x, PHP 7.0 или новее. Упаковано как расширение OCMOD.
• OpenCart 3: для магазинов на OpenCart 3.0.x, PHP 7.0 или новее. Устанавливается через встроенный установщик расширений.
• OpenCart 4: для магазинов на OpenCart 4.0.x, PHP 8.0 или новее.

Если вы не уверены, какая версия у вас установлена, номер версии выводится в правом нижнем углу панели администратора OpenCart. Скачайте подходящий архив со страницы плагинов Paynet или установите его из маркетплейса расширений OpenCart. Это одно и то же расширение в обоих случаях.

Перед установкой

Стоит подготовить две вещи.

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

Собственные аккаунты у провайдеров. Paynet не продает вам договор эквайринга. Вы приносите уже имеющиеся у вас аккаунты: карточный шлюз ARCA через ваш банк, мерчант-аккаунт Idram, мерчант-аккаунт Telcell. Вы добавляете эти реквизиты один раз в Paynet, и каждый подключенный вами магазин может ими пользоваться.

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

Установка расширения

OpenCart 2

1. В админке OpenCart перейдите в "Расширения", затем "Установщик расширений", и загрузите файл .ocmod.zip.
2. Перейдите в "Расширения", затем "Модификации", и нажмите "Обновить".
3. В разделе "Расширения", затем "Способы оплаты", найдите Paynet и нажмите "Установить", затем "Изменить".
4. Нажмите Connect и подтвердите во всплывающем окне. Магазин привяжется к вашему аккаунту Paynet.
5. Установите статус "Включено" и сохраните. Теперь ваша страница оплаты предлагает способы оплаты, которые вы подключили в Paynet.

OpenCart 3

1. В админке OpenCart перейдите в "Расширения", затем "Установщик", и загрузите файл .ocmod.zip.
2. Перейдите в "Расширения", затем "Расширения", выберите фильтр "Способы оплаты", найдите Paynet и нажмите "Установить".
3. Нажмите "Изменить", чтобы открыть настройки плагина.
4. Нажмите Connect и подтвердите во всплывающем окне.
5. Установите статус "Включено" и сохраните.

OpenCart 4

1. В админке OpenCart перейдите в "Расширения", затем "Установщик", и загрузите файл .ocmod.zip.
2. Нажмите "Установить" на загруженном архиве.
3. Перейдите в "Расширения", затем "Расширения", затем "Способы оплаты", найдите Paynet и нажмите "Установить", затем "Изменить".
4. Нажмите Connect и подтвердите во всплывающем окне.
5. Включите расширение и сохраните.

В OpenCart 3 и 4, если запись Paynet не появляется в разделе "Способы оплаты" сразу после загрузки, очистите кэш админки и перезагрузите страницу. OpenCart агрессивно кэширует скомпилированные шаблоны админки.

Что делает кнопка Connect

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

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

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

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

Один вариант оплаты для каждого способа

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

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

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

Протестируйте все перед тем, как начнут двигаться реальные деньги

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

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

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

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

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

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

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

Запуск

Три условия должны быть выполнены, прежде чем покупатель сможет заплатить вам по-настоящему.

1. Ваш бизнес верифицирован. Реальные платежи открываются после того, как Paynet проверит документы вашего бизнеса, обычно в течение одного-двух рабочих дней. До этого все работает в тестовом режиме.
2. Реальный провайдер подключен и включен для домена. Ваши собственные реквизиты ARCA, Idram или Telcell, сохраненные в Paynet и активированные для этого магазина.
3. Домен магазина верифицирован. Процесс Connect делает это за вас.

Затем переключите статус расширения на "Включено" в OpenCart, если вы еще этого не сделали, и разместите один небольшой реальный заказ самостоятельно, прежде чем о чем-либо объявлять.

Фискальные чеки

Продажи в Армении требуют фискального чека от электронной кассы, зарегистрированной в налоговой службе. Если вы подключите свой e-HDM в Paynet, чеки выпускаются автоматически для каждого успешного платежа, включая те, что поступают со страницы оплаты OpenCart, а QR-код для проверки сохраняется, чтобы его можно было показать снова позже. В магазине ничего дополнительно настраивать не нужно.

Сколько это стоит

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

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

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

1. Проверьте версию OpenCart в админке, затем скачайте подходящий архив с paynet.am/ru/plugins или установите его из маркетплейса OpenCart.
2. Установите его, откройте настройки Paynet и нажмите Connect.
3. Добавьте провайдера Sandbox, включите его для своего домена и разместите один одобренный и один отклоненный тестовый заказ.
4. Отправьте документы вашего бизнеса на верификацию и добавьте реальные реквизиты ARCA, Idram или Telcell, пока ждете.
5. Если вам также нужно управлять платежами из собственного кода, справочник по API описывает создание платежей, чтение их статуса и возвраты.

Idram, Telcell, ARCA, OpenCart и названия банков, упомянутые здесь, принадлежат своим владельцам. Paynet - независимый платежный шлюз.