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

Кожен запит на створення платежу може (опційно) супроводжуватися інформацією зі списком продуктів, за які буде проводитися оплата. Якщо така інформація буде передана у запиті, то її буде відображено на чекауті, що дозволить платнику пересвідчитися у правильності та безпечності замовлення.

Для включення до платежу інформації про продукт, його кількісні та якісні характеристики, запит на створення одностадійного (одностадійний спліт) чи двостадійного (двостадійний спліт) платежу повинен супроводжуватися такими параметрами:

Перелік параметрів з інформацією щодо продукту:

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"
}