Оплата за реквізитами

Створення рахунку та його оплата за реквізитами картки. Увага, це апі буде працювати тільки за умови наявності у мерчанта активного PCI DSS сертифіката!

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

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

  • ccy

    integer

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

  • cardData

    required

    object

    Дані картки

    cardData {

    • pan

      string

      Номер картки

    • exp

      string

      Термін дії картки у форматі mmyy

    • cvv

      string

      Cvv

  • merchantPaymInfo

    object (MerchantPaymInfoItem)

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

    merchantPaymInfo {

    • reference

      string

      Номер чека, замовлення, тощо; визначається мерчантом

    • destination

      string

      Призначення платежу

    • comment

      string

      Службове інформаційне поле

    • customerEmails

      array of string

      Масив пошт, на які потрібно відправити фіскальний чек, якщо у мерчанта активна звʼязка з checkbox

      customerEmails [

      • item

        string

    • basketOrder

      array of object

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

      basketOrder [

      • name

        required

        string

        Назва товару

      • qty

        required

        number

        Кількість одиниць товару

      • sum

        required

        integer

        Сума у мінімальних одиницях валюти за одиницю товару; якщо ви торгуєте табуретками, ціна якої 21 гривня, і у вас замовлення на 2 табуретки, то qty=2, sum=2100, amount=4200

      • icon

        string

        Лінк на зображення товару

      • unit

        string

        Назва одиниці вимiру товару

      • code

        required

        string

        Код товару, обов’язковий для фіскалізації

      • barcode

        string

        Значення штрих-коду, може бути потрібно для фіскалізації

      • header

        string

        Текст, що передує назві товару, може бути потрібний для фіскалізації

      • footer

        string

        Текст, після товару, може бути потрібний для фіскалізації

      • tax

        array of integer

        Масив податкових ставок, які було обрано на порталі Checkbox при реєстрації каси. При використанні ПРРО monopay податкові ставки наразі не застосовуються

        tax [

        • item

          integer

      • uktzed

        string

        Код УКТ ЗЕД

      • discounts

        array of object

        Масив знижок або надбавок, які будуть передані в checkbox для фіскалізації, якщо звʼязку з checkbox активовано

        discounts [

        • type

          required

          string

          Тип знижки або надбавки

          DISCOUNT — знижка

          EXTRA_CHARGE — надбавка

        • mode

          required

          string

          Режим знижки або надбавки

          PERCENT — відсоток від basketOrder.sum * basketOrder.qty

          VALUE — числове значення

        • value

          required

          number

          Значення, яке буде фігурувати в розрахунках

  • webHookUrl

    string

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

  • paymentType

    string

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

  • saveCardData

    object

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

    saveCardData {

    • saveCard

      boolean

      Ознака зберігання картки (токенізації) після оплати

    • walletId

      string

      Ідентифікатор гаманця користувача

  • redirectUrl

    string

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

  • initiationKind

    string

    Тип проведення платежу:

    merchant - платіж з ініціативи мерчанта, наприклад, регулярний платіж — коли клієнт не бере участі у підтвердженні платежу

    client - платіж за вимогою клієнта

post

/api/merchant/invoice/payment-direct

Request samples
Payload
200 Дані рахунку та оплати
400 Один із вхідних параметрів невалідний
403 Токен невалідний
405 Http-метод невалідний
429 Занадто багато запитів
500 Під час виконання запиту виникла непередбачена помилка
Response samples
200
400
403
405
429
500
Фіскальні чеки