Skip to main content

Hire purchase with monobank

monobank offers its customers the benefit of interest-free installment purchases, enabling them to split the costs into convenient payment amounts within the limits set by monobank. To utilize the payment method, the payment should be made with monobank card.

Further details on the application of this payment method as well as its terms and conditions can be found on the monobank.

To enable the payment method, you need to use direct integration.

When creating a payment, send a request with the following parameters:

pos_idUUIDMerchant's identifier (POS_ID)
amountNumberTransaction amount (min amount is 500 UAH)
currencyCURRENCYTransaction currency (ISO_4217)
descriptionStringPayment description
order_idStringUnique identifier of order
order_3ds_bypassString3-D Secure flow option
paywayStringUse mono_payparts for processing direct payments through Mono Payment by Parts
productsArray[Product]Array of products to be paid
customer_idStringCustomer identifier in merchant's system
customer_fnameStringCustomer first name
customer_lnameStringCustomer last name
customer_emailStringCustomer email
customer_phoneStringCustomer phone
customer_ipStringCustomer IP address
customer_countryStringCustomer country (ISO 3166-1 (alpha-2)). For instance, UA for Ukraine
server_urlURLWebhook notification will be sent to this URL
result_urlURLCustomer will be redirected to this URL after payment.
merchant_mccMCCMCC for this transaction
payloadStringField for merchant custom data. Max 4000 symbols.
validation_urlStringPreflight request will be sent to this URL
properties.parts_countStringThe number of parts into which the payment amount is divided (must be > 1 and <= 25)

Request example:

$ curl "" \
-H "Content-Type: application/json" \
-X POST -d '{
"pos_id": "${POS_ID}",
"mode": "direct",
"method": "auth",
"amount": 300,
"currency": "UAH",
"description": "Order description",
"order_id": "123",
"order_3ds_bypass": "always",
"payway": "mono_payparts",
"server_url": "",
"result_url": "",
"payload": "sale=true",
"properties": {
"part_counts": "2"
"products": [
"name" : "Apple",
"amount" : 100,
"currency": "UAH",
"qty" : 2
"name" : "Pineapple",
"amount" : 100,
"currency": "UAH",
"qty" : 1