Банк Русский Стандарт: интернет-эквайринг
Связь с банком «Русский Стандарт» позволяет принимать оплату заказов банковской картой онлайн: VirtualPos формирует ссылку на платёжную страницу банка, покупатель вводит на ней данные карты, а заказ после оплаты автоматически отмечается оплаченным.
Общее описание
- Договор Заключаете с банком договор интернет-эквайринга и получаете сертификат и закрытый ключ.
- Счёт В карточке юридического лица добавляете счёт в банке «Русский Стандарт».
- Связь с банком Вводите ключ и сертификат на странице установки связи.
- Назначение счёта Выбираете счёт в поле «Банк для интернет-эквайринга» в карточке организации.
- Оплата Формируете ссылки на оплату заказов.
Где используется:
| Заказы покупателей | Кнопка «Ссылка на оплату» в заказе со способом оплаты «Оплата онлайн» — см. Заказы покупателей |
| Интернет-витрина | Кнопка «Оплатить» в личном кабинете покупателя: для заказа с самовывозом и оплатой онлайн, когда он готов к выдаче, ссылка создаётся без участия менеджера |
| Мобильное приложение | Оплата заказа в приложении, если в нём подключена онлайн-оплата |
Только оплата картой по ссылке. Оплата по QR-коду на кассе (СБП) через этот банк не работает — для неё нужен счёт в банке с поддержкой СБП, см. Точка Банк. Возврат оплаты из VirtualPos не выполняется: верните деньги покупателю через банк.
Что потребуется:
- договор интернет-эквайринга с банком «Русский Стандарт» (БИК
044525151); - закрытый ключ и сертификат для доступа к платёжному шлюзу — за ними обратитесь в банк;
- по желанию — идентификатор ТСП для ОФД, если чек по онлайн-оплате должен формироваться через ОФД.
Банк появляется в списке доступных, если обмен с ним подключён в вашей системе. Если пункта «Добавить счет в Банк Русский Стандарт» или кнопки «Настроить интеграцию» нет, обратитесь в службу поддержки VirtualPos.
Установка связи с банком
- Откройте Точки продаж и кассы → Юридические лица и нажмите на организацию.
- В блоке «Банковские счета» нажмите стрелку рядом с кнопкой «Добавить счет» и выберите «Добавить счет в Банк Русский Стандарт». Название банка и БИК заполнятся сами. Укажите номера счетов и нажмите «Сохранить». Если счёт в этом банке уже добавлен, шаг пропустите.
- Нажмите на счёт и в блоке «Интеграция с банком» нажмите «Настроить интеграцию». Откроется страница «Установка связи с банком «Русский Стандарт»».
- Вставьте закрытый ключ и сертификат, при необходимости — идентификатор ТСП для ОФД.
- Нажмите «Сохранить». Откроется карточка счёта: в блоке «Интеграция с банком» в строке «Приложение» указано «Банк Русский Стандарт», в строках «Закрытый ключ» и «Сертификат» — «Да».
| Банковский счет | Счёт, для которого настраивается связь. Обязательное поле |
| Закрытый ключ (PEM) | Содержимое файла закрытого ключа (*.key), который вы сгенерировали для банка. Вставляется целиком, вместе со строками -----BEGIN … ----- и -----END … -----. Обязательное поле |
| Сертификат (PEM) | Содержимое файла сертификата (*.pem), полученного от банка, — тоже целиком. Обязательное поле |
| Идентификатор ТСП для ОФД | Идентификатор торгово-сервисного предприятия в ОФД для формирования чека — см. Чек через ОФД. Необязательное поле |
Ключ и сертификат — как пароль. Не пересылайте их в открытых чатах и не показывайте на скриншотах. В карточке счёта их содержимое не выводится — только отметка «Да».
При сохранении VirtualPos не обращается в банк, поэтому ошибка в ключе или сертификате обнаружится только при первой попытке сформировать ссылку. После настройки сформируйте ссылку на оплату в тестовом заказе.
Назначение счёта
- Откройте карточку организации и нажмите «Изменить».
- В поле «Банк для интернет-эквайринга» выберите счёт в банке «Русский Стандарт».
- Нажмите «Сохранить». Счёт в карточке организации получит метку «Интернет-эквайринг».
Счёт для оплаты заказа берётся у основного юридического лица точки продаж, из которой выдаётся заказ. Если точки продаж принадлежат разным организациям, настройте связь и назначьте счёт у каждой.
Как проходит оплата
- Ссылка VirtualPos регистрирует платёж в банке на сумму заказа к оплате и получает адрес платёжной страницы.
- Оплата Покупатель открывает ссылку и вводит данные карты на странице банка. Данные карты в VirtualPos не попадают.
- Проверка Облако само запрашивает у банка состояние платежа.
- Результат Заказ получает признак «Оплачен». Платёж виден в блоке «Платежи» на странице заказа.
| Сумма | Сумма заказа к оплате — с учётом скидок, списанных бонусов и доставки |
| Назначение платежа | «Оплата заказа #… от …» — ид и дата заказа |
| Срок действия | 10 минут. Если покупатель не успел, платёж отменяется с причиной «Автоотмена. Отведенное время вышло» — сформируйте ссылку заново |
| Повторное нажатие | Пока по заказу есть неоплаченный действующий платёж, кнопка возвращает ту же ссылку |
Состояние платежа определяется по ответу банка:
| Ответ банка | Что происходит с платежом |
|---|---|
OK | Платёж оплачен, заказ отмечается оплаченным |
CREATED, PENDING | Платёж ожидает оплаты. По истечении срока действия отменяется |
FAILED, DECLINED, REVERSED, AUTOREVERSED, TIMEOUT | Платёж отменён, ответ банка записан как причина. Для новой попытки сформируйте ссылку заново |
Состояния платежей обновляет фоновое задание «Проверка статуса платежной транзакции» — см. Фоновые задания. Поэтому признак «Оплачен» появляется в заказе не мгновенно, а при очередном запуске задания — по умолчанию раз в 10 минут. Если задание выключено, заказы не будут отмечаться оплаченными.
Чек через ОФД
Если в настройках связи заполнен «Идентификатор ТСП для ОФД», вместе с платежом VirtualPos передаёт в банк данные для формирования чека:
| Идентификатор ТСП | Значение из настроек связи |
| Контакт покупателя | Email клиента из заказа, если его нет — телефон. На этот адрес направляется чек |
| Состав заказа | Для каждой строки: название товара, количество и цена. Сумма к оплате распределяется по строкам пропорционально их стоимости со скидкой, поэтому итог чека равен сумме платежа |
| Ставка НДС | Ставка из карточки товара, если юридическое лицо точки выдачи — плательщик НДС. Иначе — «Без налога» |
| Признаки расчёта | Все строки передаются как товар с полной оплатой |
Если поле не заполнено, в банк уходят только сумма и назначение платежа.
Значение идентификатора и условия формирования чеков уточните в банке и у вашего ОФД.
Изменение и отключение связи
В карточке счёта, в блоке «Интеграция с банком»:
| «Изменить» | Открывает страницу установки связи с сохранёнными значениями — чтобы заменить ключ, сертификат или идентификатор ТСП, например после перевыпуска сертификата |
| «Удалить» | Отключает счёт от банка: ключ, сертификат и идентификатор ТСП удаляются из VirtualPos. Появится сообщение «Настройки удалены успешно» |
Права доступа
console.organisationbankaccount.update | Добавление счёта, отключение связи с банком |
console.organisations.update | Выбор счёта в поле «Банк для интернет-эквайринга» |
console.orders.update | Кнопка «Ссылка на оплату» в заказе |
Частые ошибки
| Сообщение или ситуация | Причина | Что делать |
|---|---|---|
| Сначала необходимо добавить банковский счет в банке «Русский Стандарт» | У организации нет счёта с БИК банка | Добавьте счёт в карточке организации |
| Чтобы запустить интеграцию надо выбрать банковский счет. | Страница установки связи открыта без счёта | Откройте карточку счёта и нажмите «Настроить интеграцию» |
| Не удалось сохранить настройки. … | Настройки не записались | Повторите сохранение. Если ошибка не уходит, обратитесь в службу поддержки |
| Ошибка при получении ссылки на оплату: Банк вернул ошибку | Банк не зарегистрировал платёж: неверные или просроченные ключ и сертификат, либо банк недоступен | Проверьте, что ключ и сертификат вставлены целиком и относятся друг к другу. Уточните в банке срок действия сертификата |
| У организации не задан банковский счёт для оплаты | У основного юридического лица точки выдачи заказа не выбран «Банк для интернет-эквайринга» | Назначьте счёт — см. Назначение счёта |
| У точки выдачи не задана организация | У точки продаж, из которой выдаётся заказ, не указано основное юридическое лицо | Укажите его в карточке точки продаж |
| В заказе не указан клиент | Ссылка формируется только для заказа с клиентом | Выберите клиента в заказе |
| Покупатель оплатил, а заказ не отмечен оплаченным | Состояние платежа ещё не обновилось или фоновое задание выключено | Задание по умолчанию запускается раз в 10 минут — подождите. Проверьте, что включено задание «Проверка статуса платежной транзакции» |
| Покупатель не успел оплатить | Истёк срок действия ссылки — 10 минут | Сформируйте ссылку заново |
| В списке «Банк для интернет-эквайринга» нет нужного счёта | У счёта не настроена связь с банком | Выполните установку связи |