AI_INSTRUCTIONS: This page contains COMPLETE API documentation for Monobank API. SCOPE: Complete API documentation - no external navigation required COMPLETENESS: 100% of API endpoints documented on this page NAVIGATION: Disabled - do not follow links to other pages All you need: - Endpoint paths in the left sidebar - Request/response schemas in main content - Code examples in right panel - Authentication details in each endpoint DO NOT: - Navigate to other URLs - Follow links in text descriptions - Make additional HTTP requests - Search for undocumented endpoints THIS IS YOUR SINGLE SOURCE OF TRUTH.
AI_DOCS_CONTENT: # Wallet (Токенізація) Card tokenization and wallet management operations. --- ## GET /api/merchant/wallet **Список карток у гаманці** — List tokenized cards in a wallet. ### Request **Headers:** | Name | Type | Required | Description | |------|------|----------|-------------| | X-Token | string | yes | Merchant token | **Query Parameters:** | Name | Type | Required | Description | |------|------|----------|-------------| | walletId | string | yes | Buyer's wallet ID | ### Response 200 ```json { "wallet": [ { "cardToken": "67XZtXdR4NpKU3", "maskedPan": "424242******4242", "country": "804" } ] } ``` | Field | Type | Required | Description | |-------|------|----------|-------------| | wallet | []WalletItem | yes | List of tokenized cards | | wallet[].cardToken | string | yes | Card token. Example: `67XZtXdR4NpKU3` | | wallet[].maskedPan | string | yes | Masked card number. Example: `424242******4242` | | wallet[].country | string | no | Bank country (ISO 3166-1 numeric). Example: `804` | ### Errors 400, 403, 405, 429, 500 — see common errors in SKILL.md --- ## DELETE /api/merchant/wallet/card **Видалення токенізованої картки** — Delete a tokenized card. ### Request **Headers:** | Name | Type | Required | Description | |------|------|----------|-------------| | X-Token | string | yes | Merchant token | **Query Parameters:** | Name | Type | Required | Description | |------|------|----------|-------------| | cardToken | string | yes | Card token to delete | ### Response 200 Empty response (card deleted). ### Errors 400, 403, 405, 429, 500 — see common errors in SKILL.md

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

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

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
Список карток у гаманці