Українська
Հայերեն
ქართული
English
Қазақша
Español
Français
Deutsch
Italiano
فارسی
В фокусе статьи
Покупатель сразу переходит в банковский checkout
Версия 0.2.5 убирает промежуточный экран: после создания платежной сессии CS-Cart направляет покупателя на выданный банком hosted checkout URL.
Add-on предназначен для CS-Cart и Multi-Vendor. В манифесте заявлен целевой диапазон 4.14.1–4.20.1. Это диапазон совместимости пакета, а не утверждение, что каждая промежуточная сборка уже прошла отдельную сертификацию: конкретную установку нужно проверять на лицензированном магазине.
Для настройки администратор создаёт одноразовый setup token в VPOS.am Console и вставляет его в способ оплаты. Merchant token, webhook secret и reconciliation secret импортируются серверно; банковские Client ID, логин и пароль не нужно хранить или вводить в CMS.
- без дополнительной промежуточной страницы перед банковским checkout;
- стабильная связь order id, payment id, суммы, валюты и storefront;
- отдельные test и live bindings без автоматического включения live;
- обновление add-on без повторного ввода банковских секретов.
Статус заказа меняется только после серверной проверки
Возврат браузера показывает результат покупателю, но не является доказательством оплаты для CS-Cart.
VPOS.am отправляет подписанное уведомление, а add-on проверяет его и защищает обработку от повторной доставки. Дубликат webhook не должен повторно списывать остатки, менять заказ или отправлять письмо. Если уведомление потерялось, reconciliation позволяет запросить серверный статус и восстановить согласованное состояние.
Маршруты ArCa iPay и SmartVista EPG, включая сценарии с Ameriabank, Evocabank, ACBA и другими банками Армении, активируются только по договору мерчанта, выданным банком endpoint и credentials и после пилота. Упоминание банка означает поддерживаемую архитектуру маршрута, а не партнёрство или автоматическую готовность любого терминала.
- подпись и защита от повторной обработки webhook;
- сверка payment id, order reference, суммы и валюты;
- reconciliation для пропущенных или задержанных уведомлений;
- раздельные статусы успешной оплаты, отказа, отмены и возврата.
Что входит в 0.2.5 и что требует отдельной интеграции
Модуль закрывает hosted checkout и подтверждение статусов заказов, но не обещает банковские возможности, которых нет в текущем контракте.
Текущая версия не инициирует refund из панели CS-Cart, не выполняет recurring charges и не распределяет деньги между продавцами Multi-Vendor. Возвраты могут отражаться по подтверждённому статусу провайдера, но запуск самой операции возврата остаётся отдельным банковским или операционным процессом.
Пакет 0.2.5 подготовлен для контролируемых пилотов и публикации. На дату этого анонса публичная выдача пакета в CS-Cart Marketplace ещё не активна, поэтому мы не размещаем неработающую ссылку на скачивание. После открытия публичной карточки ссылка появится на странице интеграции; до этого команда VPOS.am проверяет подключение по заявке.
- до live обязательны банковский договор и валидные test/production credentials;
- успех, отказ, отмена, дубликат webhook и reconciliation проверяются на целевом магазине;
- refund initiation, recurring и split settlements не входят в 0.2.5;
- переход в production выполняется отдельно для каждого merchant route.
FAQ
Какие версии CS-Cart поддерживает модуль?
В manifest заявлен целевой диапазон CS-Cart и Multi-Vendor 4.14.1–4.20.1. Перед production конкретную версию, PHP, тему и установленные add-ons нужно проверить на лицензированном магазине.
Нужно ли вводить банковский пароль в CS-Cart?
Нет. В CS-Cart вводится одноразовый setup token из VPOS.am Console. Он импортирует привязку установки серверно; банковские credentials остаются в защищённом контуре VPOS.am.
Можно ли уже скачать модуль из CS-Cart Marketplace?
На дату публикации публичная выдача пакета ещё не активна, поэтому прямую Marketplace-ссылку мы пока не публикуем. Оставьте заявку через страницу интеграции, чтобы согласовать пилот и получить актуальный статус релиза.
Источники и документация
- Модуль VPOS.am для CS-Cart: возможности и условия подключенияАктуальная страница интеграции, ограничения и путь пилота
- VPOS.am API DocsPayment lifecycle и серверные контракты
