UA:
Отримайте X-Token мерчанта на https://web.monobank.ua/a/merchants

Передавайте токен у поле "token" кожної дії (Server-Side Action).

Дія "Create Subscription":

amount: сума в копійках (29900 = 299 грн)

interval: "1m" щомісяця | "1y" щороку | "1w" щотижня | "2w" кожні 2 тижні

redirect_url: URL повернення після оплати

charge_webhook_url: URL для отримання події при кожному списанні коштів (рекомендовано через n8n)

status_webhook_url: URL для отримання змін статусу підписки
Повертає: subscription_id (зберегти в БД!) та page_url (відкрити для користувача)

Дія "Get Subscription Status":

subscription_id: ID з попередньої дії
Повертає: status, next_payment_date, amount, interval

Дія "Cancel Subscription":

subscription_id: ID підписки
Скасовує підписку — Monobank більше не списуватиме кошти.
Важливо: після скасування залишайте доступ до кінця оплаченого periodу (до next_payment_date).

Дія "Charge by Token":

wallet_id: walletId отриманий з webhook після першого успішного платежу (зберегти в БД)

card_token: cardToken отриманий з webhook після першого успішного платежу (зберегти в БД)

amount: сума в копійках

webhook_url: URL для отримання результату платежу
Повертає: invoice_id, page_url (якщо банк вимагає 3DS — показати клієнту), success
Використовується для поновлення підписки без переходу клієнта на сторінку Monobank.

EN:

Get your X-Token at https://web.monobank.ua/a/merchants

Pass the token via the "token" field in each action.

"Create Subscription" action:

amount: amount in kopecks (29900 = 299 UAH)

interval: "1m" monthly | "1y" yearly | "1w" weekly | "2w" every 2 weeks

redirect_url: return URL after payment

charge_webhook_url: URL to receive events on each charge (recommended via n8n)

status_webhook_url: URL to receive subscription status changes
Returns: subscription_id (save to DB!) and page_url (redirect user here)

"Get Subscription Status" action:

subscription_id: ID from the create action
Returns: status, next_payment_date, amount, interval

"Cancel Subscription" action:

subscription_id: subscription ID
Cancels the subscription — Monobank will stop charging the card.
Important: after cancellation, keep access until the end of the paid period (until next_payment_date).

"Charge by Token" action:

wallet_id: walletId received via webhook after the first successful payment (save to DB)

card_token: cardToken received via webhook after the first successful payment (save to DB)

amount: amount in kopecks

webhook_url: URL to receive the payment result
Returns: invoice_id, page_url (if 3DS is required by the bank — redirect the user), success
Used to renew a subscription without redirecting the customer to the Monobank payment page.