maib MIA QR API
RU
RU
  • Overview
    • Общие технические характеристики
    • Типы QR MIA
  • Эндпоинты
    • Аутентификация
      • Получение токена аутентификации
    • Инициация платежа
      • Создание QR-кода (статический, динамический)
      • Создание гибридного QR-кода
        • Создание расширения для QR-кода по ID
    • Отмена платежа
      • Отмена активного QR-кода (Статический/Динамический)
      • Отмена активного расширения для гибридного QR-кода
    • Возврат платежа
      • Возврат выполненного платежа
    • Получение информации (GET)
      • Отображение списка QR-кодов с параметрами фильтрации
      • Получение данных по QR по ID
      • Получение списка платежей с возможностью фильтрации
      • Получение информации о платеже по ID
  • Симуляция платежа (Sandbox)
  • Уведомления по Callback URL
  • Ошибки (Errors)
    • Ошибки API
    • Коды состояния HTTP
  • Терминология
  • maib e-commerce API
Powered by GitBook
On this page
  1. Эндпоинты

Инициация платежа

Инициация платежа в экосистеме QR MIA осуществляется путём генерации QR-кода, который можно отсканировать с помощью мобильного приложения maib или камеры телефона для выполнения оплаты.

Доступные типы QR

  • Статический QR Неподвижный QR-код, используемый в статических контекстах (например, стикеры, меню). Сумма может быть:

    • Фиксированной

    • Контролируемой (диапазон минимум-максимум)

    • Свободной (пользователь вводит сумму)

  • Динамический QR QR-код, сгенерированный для одной транзакции с фиксированной суммой и ограниченным сроком действия.

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

Этапы инициации платежа

  1. Выбор необходимого типа QR (Static, Dynamic, Hybrid)

  2. Отправка POST-запроса к соответствующему endpoint-у

  3. Указание следующих параметров:

    • Тип суммы (Fixed, Controlled, Free)

    • Валюта (только MDL)

    • Сумма или лимиты

    • Дата истечения

    • Описание заказа

    • Callback и redirect URL (для веб-интеграции)

  4. Получение ответа с данными сгенерированного QR:

    • qrId: уникальный идентификатор QR-кода

    • extensionId: идентификатор расширения (только для гибридного QR)

    • url: ссылка, которую можно отобразить, сохранить или представить в виде QR-кода

  5. Отображение QR-кода конечному пользователю

  6. Платёж выполняется путём сканирования QR-кода приложением или камерой телефона

PreviousПолучение токена аутентификацииNextСоздание QR-кода (статический, динамический)

Last updated 2 days ago