Open banking Monobank (2025.09.12)

Download OpenAPI specification:Download

Надання і відкликання згоди

Створити згоду на доступ до інформації про рахунки

Authorizations:

mTLS

header Parameters

X-Request-ID required	string <uuid> Example: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721 Ідентифікатор запиту, унікальний для виклику, визначений стороною-ініціатором
PSU-ID	string Example: UA413220010000026206347644036 Ідентифікатор користувача фізичної особи або ФОП
PSU-ID-Type	string Value: "IBAN" Example: IBAN Тип ідентифікатора користувача фізичної особи або ФОП
PSU-Corporate-ID	string Example: UA173220010000026002700000121 Ідентифікатор користувача юридичної особи
PSU-Corporate-ID-Type	string Value: "IBAN" Example: IBAN Тип ідентифікатора користувача юридичної особи
PSU-IP-Address required	string <ipv4> Example: 8.8.8.8 IP-адреса користувача платіжних послуг
TPP-Redirect-URI	string <uri> Example: https://example.com/redirect Лінк для повернення користувача у платіжний застосунок TPP

Request Body schema: application/json

required	object
consentType required	string Enum: "accountList" "detailed" Тип згоди
recurringIndicator required	boolean Повторювана згода
validTo required	string <date> Дата закінчення дії згоди
frequencyPerDay required	integer Кількість запитів на день

Responses

Request samples

Payload

Content type

application/json

{"access": {"cards": [{"account": {"iban": "UA413220010000026206347644036",
"currency": "UAH"
},
"rights": ["accountDetails"
]
}
],
"payments": [{"account": {"iban": "UA413220010000026206347644036",
"currency": "UAH"
},
"rights": ["accountDetails"
]
}
],
"savings": [{"account": {"iban": "UA413220010000026206347644036",
"currency": "UAH"
},
"rights": ["accountDetails"
]
}
],
"loans": [{"account": {"iban": "UA413220010000026206347644036",
"currency": "UAH"
},
"rights": ["accountDetails"
]
}
]
},
"consentType": "detailed",
"recurringIndicator": true,
"validTo": "2024-12-31",
"frequencyPerDay": 4
}

Response samples

201
400
401
500

Content type

application/json

{"consentId": "2409105jHHToBoHe3Lqw",
"consentStatus": "received",
"_links": {"startAuthorisation": {"href": "https://ob-ext.mono.st4g3.com/ext/v2/consents/account-access/2409105jHHToBoHe3Lqw/authorisations"
}
}
}

Ініціювати процес авторизації згоди

Authorizations:

mTLS

path Parameters

consentId

required

string

Example: 2409105jHHToBoHe3Lqw

header Parameters

X-Request-ID

required

string <uuid>

Example: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721

Ідентифікатор запиту, унікальний для виклику, визначений стороною-ініціатором

Responses

Response samples

201
400
401
500

Content type

application/json

{"authorisationId": "2409105jHHToBoHe3Lqw",
"scaStatus": "started",
"_links": {"scaRedirect": {"href": "string"
}
}
}

Отримати дані згоди

Authorizations:

mTLS

path Parameters

consentId

required

string

Example: 2409105jHHToBoHe3Lqw

header Parameters

X-Request-ID

required

string <uuid>

Example: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721

Ідентифікатор запиту, унікальний для виклику, визначений стороною-ініціатором

Responses

Response samples

200
400
401
500

Content type

application/json

{"access": {"cards": [{"account": {"iban": "UA413220010000026206347644036",
"currency": "UAH"
},
"rights": ["accountDetails"
]
}
],
"payments": [{"account": {"iban": "UA413220010000026206347644036",
"currency": "UAH"
},
"rights": ["accountDetails"
]
}
],
"savings": [{"account": {"iban": "UA413220010000026206347644036",
"currency": "UAH"
},
"rights": ["accountDetails"
]
}
],
"loans": [{"account": {"iban": "UA413220010000026206347644036",
"currency": "UAH"
},
"rights": ["accountDetails"
]
}
]
},
"consentType": "detailed",
"recurringIndicator": true,
"validTo": "2024-12-31",
"frequencyPerDay": 4,
"consentStatus": "received"
}

Відкликати згоду

Authorizations:

mTLS

path Parameters

consentId

required

string

Example: 2409105jHHToBoHe3Lqw

header Parameters

X-Request-ID

required

string <uuid>

Example: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721

Ідентифікатор запиту, унікальний для виклику, визначений стороною-ініціатором

Responses

Response samples

400
401
500

Content type

application/json

{"apiClientMessages": [{"category": "ERROR",
"code": "BAD_REQUEST",
"text": "Некоректний запит"
}
]
}

Отримати статус згоди

Authorizations:

mTLS

path Parameters

consentId

required

string

Example: 2409105jHHToBoHe3Lqw

header Parameters

X-Request-ID

required

string <uuid>

Example: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721

Ідентифікатор запиту, унікальний для виклику, визначений стороною-ініціатором

Responses

Response samples

200
400
401
500

Content type

application/json

{"consentStatus": "received"
}

Інформація про рахунки

Отримати список рахунків

Authorizations:

mTLS

query Parameters

withBalance

boolean

Example: withBalance=true

Повертати баланси рахунків

header Parameters

X-Request-ID required	string <uuid> Example: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721 Ідентифікатор запиту, унікальний для виклику, визначений стороною-ініціатором
Consent-ID required	string Example: 2409105jHHToBoHe3Lqw Ідентифікатор згоди
PSU-IP-Address	string <ipv4> Example: 8.8.8.8 IP-адреса користувача платіжних послуг

Responses

Response samples

200
400
401
500

Content type

application/json

{"accounts": [{"resourceId": "hH1eKFyoPmfLkhAuMB0ynA",
"iban": "UA413220010000026206347644036",
"currency": "UAH",
"product": "platinum",
"balances": [{"balanceAmount": {"currency": "UAH",
"amount": "100.02"
},
"balanceType": "interimAvailable",
"creditLimitIncluded": true
}
]
}
]
}

Отримати баланси рахунку

Authorizations:

mTLS

path Parameters

accountId

required

string

Example: hH1eKFyoP

Ідентифікатор рахунку

header Parameters

X-Request-ID required	string <uuid> Example: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721 Ідентифікатор запиту, унікальний для виклику, визначений стороною-ініціатором
Consent-ID required	string Example: 2409105jHHToBoHe3Lqw Ідентифікатор згоди
PSU-IP-Address	string <ipv4> Example: 8.8.8.8 IP-адреса користувача платіжних послуг

Responses

Response samples

200
400
401
500

Content type

application/json

{"account": {"iban": "UA413220010000026206347644036",
"currency": "UAH",
"product": "platinum"
},
"balances": [{"balanceAmount": {"currency": "UAH",
"amount": "100.02"
},
"balanceType": "interimAvailable",
"creditLimitIncluded": true
}
]
}

Отримати cписок транзакцій по рахунку

Authorizations:

mTLS

path Parameters

accountId

required

string

Example: hH1eKFyoP

Ідентифікатор рахунку

query Parameters

dateFrom	string <date> (ISODate) Example: dateFrom=2024-01-01 Дата початку періоду
dateTo	string <date> (ISODate) Example: dateTo=2024-01-01 Дата закінчення періоду
pageId	string Example: pageId=Fo-TMxv-PaWyxLfohg5e4keQSQEadWiIEuvZ-xBB0EQMUqKr4r6DcsxpNy2BT0jX99o1fUBtDzaFwzb7PfaKxz Ідентифікатор сторінки
bookingStatus required	string Enum: "booked" "pending" "both" Example: bookingStatus=booked Статус транзакції

header Parameters

X-Request-ID required	string <uuid> Example: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721 Ідентифікатор запиту, унікальний для виклику, визначений стороною-ініціатором
Consent-ID required	string Example: 2409105jHHToBoHe3Lqw Ідентифікатор згоди
PSU-IP-Address	string <ipv4> Example: 8.8.8.8 IP-адреса користувача платіжних послуг

Responses

Response samples

200

Content type

application/json

{"account": {"iban": "UA413220010000026206347644036",
"currency": "UAH",
"product": "platinum"
},
"transactions": {"booked": [{"transactionId": "string",
"bookingDate": "2024-01-01",
"transactionAmount": {"currency": "UAH",
"amount": "100.02"
},
"creditor": {"name": "Текст до 140 символів"
},
"debtor": {"name": "Текст до 140 символів"
},
"cardTransaction": {"transactionDateTime": "2006-01-02T15:04:05.999999999Z07:00",
"tradeName": "Текст до 70 символів",
"merchantCategoryCode": "stri"
},
"remittanceInformationUnstructured": ["Оплата за послуги згідно рахунку 314415"
]
}
],
"_links": {"first": {"href": "string"
},
"next": {"href": "string"
}
}
}
}

Платіжні послуги

Створити платіж

Authorizations:

mTLS

path Parameters

paymentProduct

required

string

Enum: "credit-transfers" "instant-credit-transfers"

Example: credit-transfers

Тип платежу

header Parameters

TPP-Redirect-URI	string <uri> Example: https://example.com/redirect Лінк для повернення користувача у платіжний застосунок TPP
X-Request-ID required	string <uuid> Example: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721 Ідентифікатор запиту, унікальний для виклику, визначений стороною-ініціатором
Content-Type required	string Example: application/json
PSU-IP-Address required	string <ipv4> Example: 8.8.8.8 IP-адреса користувача платіжних послуг
PSU-ID	string Example: UA413220010000026206347644036 Ідентифікатор користувача фізичної особи або ФОП
PSU-ID-Type	string Value: "IBAN" Example: IBAN Тип ідентифікатора користувача фізичної особи або ФОП
PSU-Corporate-ID	string Example: UA173220010000026002700000121 Ідентифікатор користувача юридичної особи
PSU-Corporate-ID-Type	string Value: "IBAN" Example: IBAN Тип ідентифікатора користувача юридичної особи

Request Body schema: application/json

Any of

required	object Сума платежу
required	object Рахунок отримувача
required	object Отримувач
remittanceInformationUnstructured	Array of strings (max140Text) = 1 items [ items <= 140 characters ] Неструктурована інформація про платіж
required	object Інформація про рахунок

Responses

Request samples

Payload

Content type

application/json

{"instructedAmount": {"currency": "UAH",
"amount": "100.02"
},
"creditorAccount": {"iban": "UA413220010000026206347644036",
"currency": "UAH"
},
"creditor": {"name": "Текст до 140 символів",
"creditorId": "string"
},
"remittanceInformationUnstructured": ["Оплата за послуги згідно рахунку 314415"
],
"debtorAccount": {"iban": "UA413220010000026206347644036",
"currency": "UAH"
}
}

Response samples

201
400
401
500

Content type

application/json

{"transactionStatus": "RCVD",
"paymentId": "Текст до 70 символів",
"_links": {"startAuthorisation": {"href": "string"
}
}
}

Отримати статус платежу

Authorizations:

mTLS

path Parameters

paymentProduct required	string Enum: "credit-transfers" "instant-credit-transfers" Example: credit-transfers Тип платежу
paymentId required	string (max70Text) <= 70 characters Example: 241212472HToBoHe3Lq1 Ідентифікатор платежу

header Parameters

X-Request-ID

required

string <uuid>

Example: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721

Ідентифікатор запиту, унікальний для виклику, визначений стороною-ініціатором

Responses

Response samples

200

Content type

application/json

{"transactionStatus": "RCVD"
}

Отримати дані платежу

Authorizations:

mTLS

path Parameters

paymentProduct required	string Enum: "credit-transfers" "instant-credit-transfers" Example: credit-transfers Тип платежу
paymentId required	string (max70Text) <= 70 characters Example: 241212472HToBoHe3Lq1 Ідентифікатор платежу

header Parameters

X-Request-ID

required

string <uuid>

Example: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721

Ідентифікатор запиту, унікальний для виклику, визначений стороною-ініціатором

Responses

Response samples

200
400
401
500

Content type

application/json

{"transactionStatus": "RCVD",
"paymentId": "Текст до 70 символів",
"instructedAmount": {"currency": "UAH",
"amount": "100.02"
},
"creditorAccount": {"iban": "UA413220010000026206347644036",
"currency": "UAH"
},
"creditor": {"name": "Текст до 140 символів",
"creditorId": "string"
},
"debtorAccount": {"iban": "UA413220010000026206347644036",
"currency": "UAH"
}
}

Відмінити платіж

Authorizations:

mTLS

path Parameters

paymentProduct required	string Enum: "credit-transfers" "instant-credit-transfers" Example: credit-transfers Тип платежу
paymentId required	string (max70Text) <= 70 characters Example: 241212472HToBoHe3Lq1 Ідентифікатор платежу

header Parameters

X-Request-ID

required

string <uuid>

Example: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721

Ідентифікатор запиту, унікальний для виклику, визначений стороною-ініціатором

Responses

Response samples

400
401
500

Content type

application/json

{"apiClientMessages": [{"category": "ERROR",
"code": "BAD_REQUEST",
"text": "Некоректний запит"
}
]
}

Ініціювати процес авторизації платежу

Authorizations:

mTLS

path Parameters

paymentProduct required	string Enum: "credit-transfers" "instant-credit-transfers" Example: credit-transfers Тип платежу
paymentId required	string (max70Text) <= 70 characters Example: 241212472HToBoHe3Lq1 Ідентифікатор платежу

header Parameters

X-Request-ID

required

string <uuid>

Example: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721

Ідентифікатор запиту, унікальний для виклику, визначений стороною-ініціатором

Responses

Response samples

201
400
401
500

Content type

application/json

{"scaStatus": "started",
"authorisationId": "string",
"_links": {"scaRedirect": {"href": "string"
},
"scaStatus": {"href": "string"
}
}
}

Отримати ідентифікатори авторизацій платежу

Authorizations:

mTLS

path Parameters

paymentProduct required	string Enum: "credit-transfers" "instant-credit-transfers" Example: credit-transfers Тип платежу
paymentId required	string (max70Text) <= 70 characters Example: 241212472HToBoHe3Lq1 Ідентифікатор платежу

header Parameters

X-Request-ID

required

string <uuid>

Example: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721

Ідентифікатор запиту, унікальний для виклику, визначений стороною-ініціатором

Responses

Response samples

200
400
401
500

Content type

application/json

{"authorisationIds": ["string"
]
}

Отримати статус авторизації платежу

Authorizations:

mTLS

path Parameters

paymentProduct required	string Enum: "credit-transfers" "instant-credit-transfers" Example: credit-transfers Тип платежу
paymentId required	string (max70Text) <= 70 characters Example: 241212472HToBoHe3Lq1 Ідентифікатор платежу
authorisationId required	string Example: 241212472HToBoHe3Lq1 Ідентифікатор авторизації

header Parameters

X-Request-ID

required

string <uuid>

Example: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721

Ідентифікатор запиту, унікальний для виклику, визначений стороною-ініціатором

Responses

Response samples

200
400
401
500

Content type

application/json

{"scaStatus": "started"
}