Интеграция Яндекс Пэй в RentProg

Интеграция RentProg с Яндекс Пэй позволяет клиенту пополнять баланс банковской картой без перехода на сторонние формы и ручного ввода реквизитов. Подключение выполняется через настройки компании в RentProg и данные мерчанта в личном кабинете Яндекс Пэй.

Регистрация и подача заявки в Яндекс Пэй

Прежде чем начать интеграцию Яндекс Пэй и RentProg, вам необходимо пройти модерацию и добавить магазин в самом Яндекс Пэй. Как зарегистрироваться в личном кабинете Яндекс Пэй и подать заявку на подключение, смотрите здесь.

Настройка Магазина с Яндекс Пэй и Сплит

Для настройки интеграции вам понадобятся:

Merchant ID магазина, для которого вы настраиваете интеграцию

Ключ Merchant API (API-ключ)

Callback URL ( https://rentprog.net/api/v1/in... )

Как узнать Merchant ID, Выпустить API-ключ, задать Callback URL смотрите здесь.

Callback URL для получения уведомлений от Яндекс Пэй в RentProg: https://rentprog.net/api/v1/in...

Тестовая интеграция (песочница)

На этапе начальной настройки используется тестовый режим Яндекс Пэй (песочница), в котором оплата не списывается реально, но проходит все шаги сценария.
Для включения данного режима в интерфейсе Яндекс Пэй есть переключатель «Тестовые данные» в разделе Настройки.
Для работы в режиме песочницы в RentProg нужно указать тестовые Merchant ID и токен API (для тестовых данных он равен Merchant ID), и включить режим «Песочницы» в интерфейсе RentProg.

Настройка в RentProg

Все параметры интеграции настраиваются в разделе: Меню → Компания → Настройки компании → Интеграции → Яндекс Пэй. В этой форме нужно указать значения Merchant ID и Токен API из личного кабинета Яндекс Пэй. Так же, обязательно нужно заполнить URL возврата, ошибки и отмены операции. Это ссылки на которые будет перенаправлен клиент в зависимости от прохождения операции оплаты. Рекомендуем подготовить данные страницы на своем сайте.

URL успешной оплаты, ошибки и отмены

Яндекс Пэй использует специальные адреса для возврата клиента после оплаты: URL успешной оплаты, URL ошибки и URL отмены. Эти страницы следует заранее создать на сайте проката и прописать их в соответствующие поля интеграции Яндекс Пэй в RentProg и в настройках Яндекс Пэй в личном кабинете.

Переход на боевую интеграцию

После успешного тестирования необходимо переключить Яндекс Пэй в боевой режим, чтобы начать принимать реальные платежи. Для этого в личном кабинете Яндекс Пэй выключите режим песочницы и опцию «Тестовые данные», укажите боевой Merchant ID и сгенерируйте реальный API-токен.

Проверка работы после настройки

После сохранения параметров в RentProg создайте тестовое бронирование и выполните оплату через Яндекс Пэй с реальными данными карты, чтобы убедиться, что клиент корректно возвращается на нужные страницы и статус оплаты в системе обновляется. При любых ошибках (неверный Merchant ID, токен или URL) Яндекс Пэй вернёт сообщение об ошибке, а параметры интеграции в RentProg можно скорректировать и повторить проверку.

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

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

Важно!

Ссылки сгенерированные через личный кабинет в Яндекс Пэй не будут обработаны в RentProg. Только ссылки сгенерированные через RentProg будут обработаны корректно.