Створення рахунку

Інтеграція дозволяє здійснювати оплату безпосередньо у мобільному застосунку. Покупці можуть обирати різні способи оплати: карткою, через застосунок monobank, Apple Pay/Google Pay або збереженою токенізованою карткою.

Можливості

  • Використання токенізованих карток для швидких платежів
  • Збереження токена карти для повторних транзакцій
  • Передавання до API змісту кошика замовлення
  • Встановлення типа платежу:
    • debit — звичайна оплата карткою або іншим способом
    • hold — блокування коштів на картці та фіналізація пізніше

Як працює API оплати в застосунку

  • 1

    Клієнт додає товари або послуги до кошика в мобільному застосунку чи на сайті продавця.

  • 2

    Ви надсилаєте запит до API на створення рахунку, передаючи такі параметри

  • 3

    API повертає посилання на платіжну сторінку, яку можна відкрити у вебпереглядачі або вбудувати у застосунок. Клієнт бачить різні способи оплати (картка, Apple Pay/Google Pay).

  • 4

    Клієнт обирає бажаний спосіб оплати та підтверджує транзакцію.

  • 5

    Після завершення оплати ви отримуєте callback із підтвердженням транзакції та деталями.

Якщо ваш застосунок підтримує модель підписки або повторні транзакції, ознайомтеся з API для токенізації карток у розділі Токенізація.

Створення рахунку для оплати

HEADER PARAMETERS:

  • X-Token

    required

    string

    Токен з особистого кабінету https://web.monobank.ua/ або тестовий токен з https://api.monobank.ua/

  • X-Cms

    string

    Назва CMS, якщо ви розробляєте платіжний модуль для CMS

  • X-Cms-Version

    string

    Версія CMS, якщо ви розробляєте платіжний модуль для CMS

REQUEST BODY SCHEMA: application/json

  • amount

    required

    integer <int64>

    Сума оплати у мінімальних одиницях (копійки для гривні)

  • ccy

    integer <int32>

    ISO 4217 код валюти, за замовчуванням 980 (гривня)

  • merchantPaymInfo

    object (MerchantPaymInfoItem)

    Інформаційні дані замовлення, яке буде оплачуватись. Обовʼязково вказувати при активній звʼязці з ПРРО (звʼязка створюється у веб-кабінеті https://web.monobank.ua)

    merchantPaymInfo {

  • redirectUrl

    string

    Адреса для повернення (GET) - на цю адресу буде переадресовано користувача після завершення оплати (у разі успіху або помилки)

  • webHookUrl

    string

    Адреса для CallBack (POST) – на цю адресу буде надіслано дані про стан платежу при зміні статусу, окрім статусу expired. Зміст тіла запиту ідентичний відповіді запиту “Статус рахунку”. Гарантії доставки повідомлень одне за одним не надається. Тобто, може бути ситуація, коли вебхук про успішну оплату (status=success) прийде раніше за вебхук про обробку цієї оплати (status=processing). Краще орієнтуватись на поле modifiedDate при аналізі поточного статусу рахунку. Вебхук із більшим modifiedDate буде актуальним.

    Окрім вебхуків при зміні статусу рахунку, вебхуки також будуть приходити при зміні статусу токенізоваї картки, якщо обʼєкт saveCardData було вказано при створенні рахунку

  • validity

    integer <int64>

    Строк дії в секундах, за замовчуванням рахунок перестає бути дійсним через 24 години

  • paymentType

    string

    default: debit

    enum:
    debithold

    Тип операції. Для значення hold термін складає 9 днів. Якщо через 9 днів холд не буде фіналізовано — він скасовується

  • qrId

    string

    Ідентифікатор QR-каси для встановлення суми оплати на існуючих QR-кас

  • code

    string

    Код терміналу субмерчанта, з апі “Список субмерчантів”. Доступний обмеженому колу мерчантів, які точно знають, що їм це потрібно

  • saveCardData

    object

    Дані для збереження (токенізації) картки. Для підключення функції, зверніться, будь ласка, в службу турботи monobank. Токенізація недоступна за замовчуванням

    saveCardData {

  • agentFeePercent

    number <float>

    Відсоток комісії, який агент встановлює для себе

  • tipsEmployeeId

    string

    Ідентифікатор співробітника, який може отримати чайові після оплати; ідентифікатор можна взяти з апі “Список співробітників”

  • displayType

    string

    enum:
    iframe

    Отримання клієнтом посилання iframe для відображення віджета (якщо параметр не передано, то звичайне посилання)

post

/api/merchant/invoice/create

Request samples
Payload

200 Посилання на оплату рахунку

400 Один із вхідних параметрів невалідний

403 Токен невалідний

404 Пошук за одним із параметрів запиту завершився неуспішно

405 Http-метод невалідний

429 Занадто багато запитів

500 Під час виконання запиту виникла непередбачена помилка

Response samples
200
400
403
404
405
429
500
Статус рахунку