Оплата по токену

Створення платежу за токеном картки

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

  • cardToken

    required

    string

    Токен картки

  • amount

    required

    integer <int64>

    Сума у мінімальних одиницях

  • ccy

    required

    integer <int32>

    ISO 4217 код валюти

  • redirectUrl

    string

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

  • webHookUrl

    string

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

  • initiationKind

    required

    string

    enum:
    merchantclient

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

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

    client - платіж за вимогою клієнта, наприклад, клієнт виконує оплату зі збереженої картки

  • merchantPaymInfo

    object (MerchantPaymInfoItem)

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

    merchantPaymInfo {

  • paymentType

    string

    default: debit

    enum:
    debithold

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

post

/api/merchant/wallet/payment

Request samples
Payload

200 Дані платежу

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

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

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

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

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

Response samples
200
400
403
405
429
500
Список карток у гаманці