Հայերեն
Українська
ქართული
English
Қазақша
Español
Français
Deutsch
Italiano
فارسیОписание
Интеграция VPOS.am с Yii2 backend: payment sessions, server-side status verification, signed webhooks, idempotency, audit log и синхронизация с CRM/ERP.
Что подключает VPOS.am
Для Yii2 обычно используется API-first интеграция. Yii2-приложение создает заказ и платежную сессию, а VPOS.am нормализует provider flow и события.
Можно подключать bank vPOS, ArCa card flow и wallet/provider routes в зависимости от договора и доступов.
- создание платежной сессии или payment link
- сохранение order id, payment id и provider reference
- проверка суммы, валюты и terminal status до изменения заказа
Payment flow и возможности
Типовой flow: сайт или backend создает заказ, VPOS.am создает платежную попытку, клиент переходит в hosted checkout или wallet-flow, затем результат подтверждается callback, status lookup или сверкой.
После подтверждения событие можно передать в CMS, CRM, ERP, fiscal queue, уведомления или внутренний dashboard. Повторные webhooks и retries обрабатываются идемпотентно.
- created, pending, paid, failed, canceled, refunded и manual review statuses
- callback/status lookup, signed events и audit trail
- refund/void workflow только при поддержке провайдера и договора
Обязательные требования к сайту для VPOS
До production-подключения банк или платежный провайдер обычно проверяет не только технический checkout, но и публичную информацию на сайте. Эти требования лучше закрыть до подачи заявки, чтобы не терять время на повторный review.
Если сайт работает на нескольких языках, одинаковая обязательная информация должна быть размещена на каждом языке. Для Армении армянская версия обязательна, даже если дополнительно есть русский, английский или другой язык.
- Политика конфиденциальности и политика обработки персональных данных
- Политика отмены и возврата, включая прямое указание, если товар или услуга не подлежит возврату
- Terms and Conditions: условия продажи, доставки товара или предоставления услуги
- Цены на товары или услуги до оплаты
- Контактные данные: телефон, e-mail, мессенджеры или другой рабочий канал связи
- Армянский язык как обязательная версия сайта; при наличии других языков информация дублируется на них
Кому подходит и ограничения
Подходит для: кастомные кабинеты и порталы на Yii2; B2B-счета, подписки, бронирования и услуги; проекты с очередями, webhooks и CRM/ERP handoff.
VPOS.am не является банком или эквайером. Комиссии, доступность методов оплаты, сроки settlement, требования к сайту, Apple Pay, refunds и production credentials подтверждаются отдельно с банком или платежным провайдером.
- начинать с одного провайдера и одного бизнес-процесса
- проверять legal pages, HTTPS, callback URLs и тестовые платежи
- переходить в production только после evidence и operator review
Частые вопросы
Что нужно подготовить до подключения VPOS?
Нужны сайт с HTTPS, публичные legal pages, цены, контакты, армянская версия сайта, выбранный банк или платежный provider, тестовые доступы, callback/return URLs и понятная карта статусов заказа или услуги.
Можно ли сразу переходить в production?
Нет. Сначала нужно пройти test payment, проверить callback/status lookup, отказанные платежи, refund или cancel сценарий при поддержке provider, логи и ручной review спорных статусов.