Інформація про продукти та ціни
Кожен запит на створення платежу може (опційно) супроводжуватися інформацією зі списком продуктів, за які буде проводитися оплата. Якщо така інформація буде передана у запиті, то її буде відображено на чекауті, що дозволить платнику пересвідчитися у правильності та безпечності замовлення.
Для включення до платежу інформації про продукт, його кількісні та якісні характеристики, запит на створення одностадійного (одностадійний спліт) чи двостадійного (двостадійний спліт) платежу повинен супроводжуватися такими параметрами:
Перелік параметрів з інформацією щодо продукту:
Parameter | Type | Description |
---|---|---|
id | String | Product identifier in merchant's system |
url | String | Product URL |
category | String | Product category |
name | String | Product name |
description | String | Product description |
amount | Number | Product price (does not influence total payment amount). Max two decimals (e.g. 123.45) |
currency | String | Product price currency |
price_type | String | Either VAT or NET |
vat | Number | VAT price for the product |
qty | Number | Product quantity. Max three decimals (e.g. 1.455) |
unit | String | Measuring unit for a specific product (kg, l, m, pc) |
payload | String | Field for custom data. Max 4000 symbols. |
Всі наведені параметри є опційними.
При передачі інформації про продукти послідовно відпрацьовують валідації:
- За сумою за кожним продуктом (
amount
*qty
) з урахуванням загального правила округлення з максимальною кількістю два знаки після коми (напр. 123.45). - За загальною сумою всіх продуктів у запиті (product 1 + product 2 + … + product x)
Приклад частини запиту на створення платіжної сесії, що містить інформацію про продукт:
{
"id": "1",
"url": "https://example.com/products/tv",
"category": "TV",
"name": "Brand new TV",
"description": "Brand new TV with awesome screen",
"amount": 6600,
"currency": "UAH",
"price_type": "VAT",
"vat": 6600,
"qty": 1,
"payload": "ref_no=1231; discount=false"
}