Техническая схема интеграции

Deeplink: переход к Партнеру

Deeplink используется для перехода на экран оплаты в мобильном приложении Партнера. Адрес, формат и набор передаваемых параметров определяются API Партнера и согласовываются с командой Rahmat Pay.

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

Поддерживаемые типы ссылок:

Universal Links для iOS;

App Links для Android;

ссылки с собственной URI-схемой, например partner-app://payment.

Партнер должен предоставить:

шаблон ссылки для каждого поддерживаемого типа;

описание параметров и их форматов;

правила кодирования параметров;

ссылки на App Store и Google Play;

URL мобильной страницы Web Checkout, если она поддерживается.

Для Universal Links и App Links необходимо использовать схему https.

Callback: уведомление о результате платежа

После успешного списания или холдирования денежных средств сервер Партнера должен отправить Callback в Rahmat.

Callback выполняется серверным POST-запросом и не должен зависеть от состояния мобильного приложения, браузера или WebView.

Назначение Callback:

подтверждение успешного списания или холдирования;

передача идентификатора транзакции Партнера;

передача фактической суммы операции;

передача времени платежа и дополнительных реквизитов операции;

синхронизация статуса платежа между системами Партнера и Rahmat.

Платеж считается успешно переданным в Rahmat только после получения положительного ответа на Callback.

Если Rahmat вернул ошибку, Партнер должен обработать ее согласно согласованному сценарию. Если списание уже выполнено, может потребоваться отмена или возврат операции.

При таймауте или временной технической ошибке Партнер должен повторить Callback с теми же идентификаторами. Повторная отправка не должна создавать новую транзакцию.

Перенаправление Пользователя по return_url не заменяет Callback и не является подтверждением платежа.

Интеграция через WebView внутри приложения Партнера

Если Партнер поддерживает сканирование QR-кодов Rahmat внутри своего приложения, платежные страницы Rahmat могут открываться во встроенном WebView.

Разрешенные домены:

app.rhmt.uz;

l.rhmt.uz;

l.multicard.uz;

link.multicard.uz.

Страницы необходимо открывать только по протоколу HTTPS.

Перед открытием URL приложение должно проверить точное значение его host. Нельзя проверять разрешенный домен только по наличию подстроки в адресе.

Заголовок User-Agent

При открытии страницы приложение Партнера должно передавать заголовок User-Agent, содержащий:

название приложения;

версию приложения;

номер сборки, если доступен;

название и версию операционной системы.

Пример:

Заголовок позволяет Rahmat определить, что страница открыта внутри приложения Партнера, и применить соответствующий пользовательский сценарий.

В частности, Rahmat может:

не отображать повторный выбор платежного приложения;

сформировать Deeplink для возврата в приложение Партнера;

адаптировать интерфейс платежной страницы для WebView.

Приложение Партнера должно корректно обрабатывать переходы из WebView по согласованному Deeplink и открывать соответствующий экран оплаты.

Deeplink: переход к Партнеру#

Callback: уведомление о результате платежа#

Интеграция через WebView внутри приложения Партнера#

Заголовок User-Agent#

Deeplink: переход к Партнеру

Callback: уведомление о результате платежа

Интеграция через WebView внутри приложения Партнера

Заголовок User-Agent