Продукти та ціни спліт-платежу

Кожен запит на створення Split-платежу може супроводжуватися (а в окремих випадках для - обов’язково) інформацією про перелік товарів або послуг у межах платежу. Для цього використовується масив products, який дозволяє передавати список товарів/послуг для конкретного саб-мерчанта (sub_merchant_id) у межах одного Split-платежу.

При використанні сервісів Оплата частинами Monobank та PrivatBank передача масиву products є обов’язковою.

Масив products може бути переданий лише для окремих саб-мерчантів у межах Split-платежу. Якщо масив products передано і він не порожній, застосовується бізнес-валідація: сумарна вартість товарів повинна відповідати сумі відповідного саб-платежу (split[i].amount).

Для включення інформації про товари або послуги до Split-платежу запит на створення платежу повинен містити параметр products з описом товарів, їх кількісних та якісних характеристик.

У кожному split[] опціонально доступні поля:

"split[]": {
  "sub_merchant_id": string,
  "amount": number,
  "products": [
    {
      "name": "Aname",
      "amount": 1,
      "currency": "UAH",
      "qty": 5,
      "id": "1",
      "unit": "kg",
    }
  ]
}

Для кожного продукту: lineAmount = (amount * qty)

qty за замовчуванням = 1, якщо не передано
amount - максимум 2 знаки після коми
qty - максимум 3 знаки після коми

Example of a full split request:

-X POST -d '{
  "pos_id": "${POS_ID}",
  "mode": "hosted",
  "method": "purchase",
  "amount": 100,
  "currency": "UAH",
  "description": "description_1",
  "order_id": "123",
  "order_3ds_bypass": "always",
  "server_url": "https://callback.blackhole.com/callback",
  "result_url": "https://example.com/result",
  "split": [
    {
      "sub_merchant_id": "6c833321-9e48-4ad7-9708-fead9f60a1b4",
      "amount": 70,
      "products": [
        {
          "id": "1",
          "name": "Aname",
          "amount": 70,
          "currency": "UAH",
          "qty": 5,
        }
      ]
    },
    {
      "sub_merchant_id": "9a124f88-3b9e-4a3d-8c7e-4d1c2f8e91aa",
      "amount": 30,
      "products": [
        {
          "id": "1",
          "name": "Вname",
          "amount": 30,
          "currency": "UAH",
          "qty": 1,
        }
      ]
    }
  ]
}'