API відповідей банку по кешбеку

Документація API відповідей банку по кешбеку

Створення відповіді банку по кешбеку

Увага: банк має надсилати інформацію про нарахування кешбеку та повернення нарахування у разі refund.

Ендпоінт: /cashback-bank-responses

Метод: POST

Опис: Створення нового запису відповіді банку по кешбеку для підтвердження сум, наданих банком.

Заголовки: x-trace-id uuid

Тіло запиту

Поле	Тип	Обов’язковий	Опис
`bankId`	UUID	Так	PartnerId банку, що надав відповідь по кешбеку
`transactionId`	string	Так	ID транзакції з чека
`sku`	number[]	Ні	SKU товарів (необов’язково)
`cashbackBankAmount`	number	Так	Сума кешбеку від банку

{
  "bankId": "d516012c-a832-11ec-b909-0242ac120002",
  "transactionId": "2qtL1H/HGEeJ8iV3eiLwdQ==",
  "sku": [2553379, 2553380, 2553381],
  "cashbackBankAmount": 15.50 //-15.50 in the refund case
}

Відповідь

Поле	Тип	Опис
`id`	UUID	Унікальний ідентифікатор відповіді банку по кешбеку
`bankId`	UUID	ID банку, що надав відповідь по кешбеку
`transactionId`	string	ID транзакції з чека
`sku`	number[]	SKU товарів (необов’язково)
`cashbackBankAmount`	number	Сума кешбеку від банку
`createdAt`	Date	Час створення
`updatedAt`	Date	Час останнього оновлення

{
  "id": "596753f9-aba5-4f2f-b114-f8e04fcd1557",
  "bankId": "d516012c-a832-11ec-b909-0242ac120002",
  "transactionId": "2qtL1H/HGEeJ8iV3eiLwdQ==",
  "sku": [2553379, 2553380, 2553381],
  "cashbackBankAmount": 15.50,
  "createdAt": "2025-07-18T09:39:27.791Z",
  "updatedAt": "2025-07-18T09:39:27.791Z"
}

Помилки

HTTP-код	Тип помилки	Опис
400	BadRequestException	Невалідні дані запиту або помилка валідації
404	NotFoundException	Чек з указаним transactionId та bankId не знайдено
500	DatabaseException	Помилка бази даних