Skip to main content

Обзор возможностей

Что такое эквайринг?

Эквайринг (Acquiring) — это решение, которое обеспечивает удобный и безопасный процесс безналичного приема платежей с использованием банковских карт и систем бесконтактной оплаты. С помощью эквайринга продавцы услуг могут принимать оплату от клиентов через платежный сервис Beepul — включая анонимную веб-оплату, без необходимости регистрации пользователя.

Acquiring

Универсальная Deeplink-ссылка для оплаты

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

Основные функциональные задачи​

  • Backend Beepul создаёт платёж и перенаправляет пользователя на страницу:

    • мобильного приложения Beepul,
    • WEB-страницу анонимной оплаты Beepul.

  • После успешной оплаты осуществляется обратный вызов (callback) на указанный URL.

  • Если предусмотрено бизнес-логикой Партнера, используется закодированный URL (url возврата) в формате base64.

  • Таймаут возврата — 5 секунд.

Инструкция по созданию deeplink

info

Backend Beepul создаёт платёж с заранее заполненными данными (переданными в кодировке Base64) и перенаправляет пользователя на страницу анонимной оплаты Beepul.

После успешной оплаты:

  • По завершении оплаты пользователь будет автоматически возвращён на указанный URL возврата, если он предусмотрен логикой партнёра.
  • Если интеграция требует подтверждения через callback — он будет отправлен на заранее согласованный endpoint.

Прод​

https://checkout.beepul.uz

Тест​

https://checkout-test.beepul.uz

Операция callback​

  • Клиент будет перенаправлен на URL возврата автоматически после оплаты.
  • Также предусмотрен таймаут 5 секунд: если ручной переход не произошёл, система выполнит автоматический редирект.
warning

Убедитесь, что URL возврата корректно закодирован (например, через encodeURIComponent) и принимает необходимые параметры для обработки результата.

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

Пример

https://beepul.uz/actions/payment?qr=bT0xMDAxJmFjLnBob25lX251bWJlcj05MTk5OTM5NDkmYW1vdW50PTEwMDAwJmNyPTg2MA

Пример:

Base64 (Decode) = m=1001&ac.phone_number=919993949&amount=10000&cr=860

Base64 (Encode) = bT0xMDAxJmFjLnBob25lX251bWJlcj05MTk5OTM5NDkmYWMuYW1vdW50PTEwMDAmY3I9ODYw
warning

Параметры передаются в теле URL, обязательно кодируются с помощью Base64.

Параметры, передаваемые в закодированном виде:​

ПолеОписаниеПримерПримечание
mИдентификатор мерчанта1010Выдается Beepul
ac.{key}Дополнительные параметрыphone_number=900977945Ключ зависит от требований мерчанта: clientid, phone_number, orderId
amountСумма оплаты в тийинах100000Без разделителей, в минимальных единицах валюты

Дополнительные параметры запроса

ПолеОписаниеПримечание
qr{2 or 3}Партнер будет предоставлять своим клиентам оплату товаров и услуг через QR-код2 - статичный QR
3 - динамический QR
Статичный QR-код будет сканироваться через приложение Beepul и перенаправлять клиента на страницу оплаты мерчанта, где он сам будет вводить сумму оплаты.
Динамичный QR-код при сканировании будет открывать приложение Beepul, где клиенту уже будет выставлен счет, который можно оплатить выбрав карту.

Оплата через WEB

1. Web-страница оплаты по уже созданному чеку​

Пример web страницы оплаты - когда чек создан. Партнёр может передать все данные для заполнения в создаваемой ссылке. Пользователь попадёт сразу на страницу, где необходимо ввести только данные карты:

  • номер
  • срок действия
  • авторизация платежа с помощью ОТР
  1. Страница оплаты, где нужно ввести номера банковской карты и дату истечения срока карты

Acquiring

  1. Страница подтверждения оплаты - аутентификация, где необходимо ввести OTP код отправленные на номер телефона плательщика

Acquiring

  1. Страница успешности оплаты, с этой страницы будет редирект на страницу возврата

Acquiring

2. Web-страница оплаты с созданием чека (только сумма)​

Ссылка генерируется с указанием параметров для предварительного создания чека. Пользователь попадает на страницу, где необходимо ввести ввести только сумму оплаты:

  • сумма

Это удобно, если сумма — единственное, что должен указать пользователь (например, пополнение баланса). В этом случае в запросе необходимо передавать поле qr равное 2 и в base64 заполненным поле ac.phone_number=910115525.

Acquiring

3. Web-страница оплаты с ручным вводом всех данных​

Партнёр создаёт ссылку, ведущую на форму, где пользователь самостоятельно заполняет все данные:

  • сумма оплаты
  • назначение платежа
  • реквизиты карты

Если в запросе в ссылке base64 не передавать поле ac.{key}={value}, поле qr равное 2 ,то, откроется страница, где пользователь должен будет заполнить поля номер телефона и сумма оплаты вручную.

Acquiring​

Оплата счетов через мобильные приложения Beepul, Hambi

Создание QR кода​

Партнерам Beepul предоставляется функционал оплаты на местах в том числе через QR коды. При генерации счета, полученный QR код можно отсканировать и совершить оплату через приложения Beepul и Hambi.

Acquiring

Пример созданного чека с QR кодом.

При сканировании QR кода пользователь перенаправляется на следущий url:

https://beepul.uz/actions/payment?qr=2&cmVjZWlwdElkPWU4NTA0MDI3LTc3ODYtNGI4ZS1iOGMxLWU1YjQ5NTZkODNlMCZpc0Fub255bT10cnVl

Оплата через:​

Beepul​

Чтобы провести оплату по QR коду, требуется открыть вкладку для сканирования в приложении Beepul как указано ниже. Acquiring

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

Acquiring

Hambi​

Приложение Hambi предоставляет схожий функционал для оплаты по QR кодам. Ниже приведен пример функционала после сканирования QR кода.

Acquiring