Skip to main content

Payment parts from Privat

Payment parts from Privat is a cost-effective loan, given to a customer in accordance with a credit limit set in case of payment for a product/service in trade and service enterprises and/or online stores. This payment method is available for use exclusively with a Privatbank card. To learn more about the specifics of how this payment method works and the terms of service provision, visit the bank's website.

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)
methodMETHODPayment method (auth or purchase)
amountNumberTransaction amount (must be > 300 UAH)
currencyCURRENCYTransaction currency (ISO_4217)
descriptionStringPayment description
order_idStringUnique identifier of order
order_3ds_bypassString3-D Secure flow option
paywayStringOptional payway. Use "privat_payparts" for processing direct payments through Privat 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": "purchase",
"amount": 300,
"currency": "UAH",
"description": "Order description",
"order_id": "123",
"order_3ds_bypass": "always",
"payway": "privat_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