Callback / Response - SALE_PART Приватбанк

Редірект в додаток синхронний режим

В параметрі redirect_url вказано пусте значення. Приватбанк надішле запит на оформлення оплати частинами в додаток на телефоні платника.

Редірект в додаток актуальний у випадку коли введений номер телефону підв'язаний у Приватбанк.

{
  "action":"SALE",
  "result":"REDIRECT",
  "status":"REDIRECT",
  "order_id":"546-4588",
  "trans_id":"39649-42645-29973",
  "trans_date":"2023-10-05 08:24:24",
  "redirect_url":null,
  "redirect_params":null,
  "redirect_method":"GET"
}

array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'REDIRECT',
  'order_id' => '546-45811465476r4367',
  'trans_id' => '36618-67917-29503',
  'trans_date' => '2022-10-19 13:39:51',
  'redirect_url' => null,
  'redirect_params' => null,
  'redirect_method" => 'GET',
)

Редірект на веб сторінку синхронний режим

В параметрі redirect_url вказано посилання по якому треба перенаправити платника для авторизації на веб сторінці Приватбанк та оформлення оплати частинами.

Редірект на веб сторінку актуальний у випадку коли введений номер телефону не підв'язаний у Приватбанк.

{
  "action":"SALE",
  "result":"REDIRECT",
  "status":"REDIRECT",
  "order_id":"546-4588",
  "trans_id":"39649-42645-29973",
  "trans_date":"2023-10-05 08:24:24",
  "redirect_url":"https:\/\/payparts2.privatbank.ua\/ipp\/v2\/payment?token=172F1869B9954BE8BFF6FD493294EAD",
  "redirect_params":null,
  "redirect_method":"GET"
}

array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'REDIRECT',
  'order_id' => '546-45811465476r4367',
  'trans_id' => '36618-67917-29503',
  'trans_date' => '2022-10-19 13:39:51',
  'redirect_url' => 'https:\/\/payparts2.privatbank.ua\/ipp\/v2\/payment?token=172F1869B9954BE8BFF6FD493294EAD',
  'redirect_params' => null,
  'redirect_method" => 'GET',
)

При успішній оплаті синхронний режим

array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'SETTLED',
  'order_id' => '4385323',
  'trans_id' => '28261-47789-28578',
  'trans_date' => '2020-02-25 07:12:58',
  'descriptor' => NULL,
  'hash' => '********************************',
)

Параметр	Опис

Параметр	Опис
`action`	`SALE`
`result`	`SUCCESS`
`status`	`SETTLED`
`order_id`	Унікальний ордер ID транзакції в системі мерчанта
`trans_id`	Унікальний ордер ID транзакції в системі Platon
`trans_date`	Час проведення транзакції в форматі UTC (YYYY-MM-DD HH-MM-SS)
`descriptor`	NULL
`hash`	Зашифрований підпис для перевірки достовірності коллбека `md5( strtoupper( strrev(email). client_pass. trans_id ) )` Увага! Якщо в запиті на оплату не було вказано `email`, то при перевірці `sing` в підписі Callback варто вказати пусте значення `email`.

При успішній оплаті з HOLD синхронний режим

HOLD активується на боці PSP Platon по запиту в чаті.

array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'PENDING',
  'order_id' => '4385323',
  'trans_id' => '28261-47789-28578',
  'trans_date' => '2020-02-25 07:12:58',
  'descriptor' => NULL,
  'hash' => '********************************',
)

Параметр	Опис

Параметр	Опис
`action`	`SALE`
`result`	`SUCCESS`
`status`	`PENDING`
`order_id`	Унікальний ордер ID транзакції в системі мерчанта
`trans_id`	Унікальний ордер ID транзакції в системі Platon
`trans_date`	Час проведення транзакції в форматі UTC (YYYY-MM-DD HH-MM-SS)
`descriptor`	NULL
`hash`	Зашифрований підпис для перевірки достовірності коллбека `md5( strtoupper( strrev(email). client_pass. trans_id ) )` Увага! Якщо в запиті на оплату не було вказано `email`, то при перевірці `sing` в підписі Callback варто вказати пусте значення `email`.

При невдалій оплаті синхронний режим

Увага! Є випадки коли Приватбанк не повертає фінальний статус при невдалій оплаті - в такому кейсі коллбеку з фінальним статусом не буде.

array (
  'action' => 'SALE',
  'result' => 'DECLINED',
  'status' => 'DECLINED',
  'order_id' => '4092002',
  'trans_id' => '28076-29879-99538',
  'trans_date' => '2020-02-03 20:49:47',
  'decline_reason' => 'Declined by processing',
  'hash' => '********************************',
)

Параметр	Опис

Параметр	Опис
`action`	`SALE`
`result`	`DECLINED`
`status`	`DECLINED`
`order_id`	Унікальний ордер ID транзакції в системі мерчанта
`trans_id`	Унікальний ордер ID транзакції в системі Platon
`trans_date`	Час проведення транзакції в форматі UTC (YYYY-MM-DD HH-MM-SS)
`descriptor`	NULL
`decline_reason`	Причина відміни транзакції
`hash`	Зашифрований підпис для перевірки достовірності коллбеку `md5( strtoupper( strrev(email). client_pass. trans_id ) )` Увага! Якщо в запиті на оплату не було вказано `email`, то при перевірці `sing` в підписі Callback варто вказати пусте значення `email`.

Проміжна відповідь асинхронний режим

{
  "action":"SALE",
  "result":"ACCEPTED",
  "order_id":"4385302",
  "trans_id":"28261-34099-19648",
  "trans_date":"2020-02-25 06:50:09"
}

Параметр	Опис

Параметр	Опис
`action`	`SALE`
`result`	`ACCEPTED`
`order_id`	Унікальний ордер ID транзакції в системі мерчанта
`trans_id`	Унікальний ордер ID транзакції в системі Platon
`trans_date`	Час проведення транзакції в форматі UTC (YYYY-MM-DD HH-MM-SS)

Редірект в додаток асинхронний режим

В параметрі redirect_url вказано пусте значення. Приватбанк надішле запит на оформлення оплати частинами в додаток на телефоні платника.

Редірект в додаток актуальний у випадку коли введений номер телефону підв'язаний у Приватбанк.

array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'REDIRECT',
  'order_id' => '546-45811465476r4367',
  'trans_id' => '36618-67917-29503',
  'trans_date' => '2022-10-19 13:39:51',
  'redirect_url' => null,
  'redirect_params' => null,
  'redirect_method" => 'GET',
)

Редірект на веб сторінку асинхронний режим

В параметрі redirect_url вказано посилання по якому треба перенаправити платника для авторизації на веб сторінці Приватбанк та оформлення оплати частинами.

Редірект на веб сторінку актуальний у випадку коли введений номер телефону не підв'язаний у Приватбанк.

array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'REDIRECT',
  'order_id' => '546-45811465476r4367',
  'trans_id' => '36618-67917-29503',
  'trans_date' => '2022-10-19 13:39:51',
  'redirect_url' => 'https:\/\/payparts2.privatbank.ua\/ipp\/v2\/payment?token=172F1869B9954BE8BFF6FD493294EAD',
  'redirect_params' => null,
  'redirect_method" => 'GET',
)

При успішній оплаті асинхронний режим

array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'SETTLED',
  'order_id' => '4385323',
  'trans_id' => '28261-47789-28578',
  'trans_date' => '2020-02-25 07:12:58',
  'descriptor' => NULL,
  'hash' => '********************************',
)

Параметр	Опис

Параметр	Опис
`action`	`SALE`
`result`	`SUCCESS`
`status`	`SETTLED`
`order_id`	Унікальний ордер ID транзакції в системі мерчанта
`trans_id`	Унікальний ордер ID транзакції в системі Platon
`trans_date`	Час проведення транзакції в форматі UTC (YYYY-MM-DD HH-MM-SS)
`descriptor`	NULL
`hash`	Зашифрований підпис для перевірки достовірності коллбека `md5( strtoupper( strrev(email). client_pass. trans_id ) )` Увага! Якщо в запиті на оплату не було вказано `email`, то при перевірці `sing` в підписі Callback варто вказати пусте значення `email`.

При успішній оплаті з HOLD асинхронний режим

HOLD активується на боці PSP Platon по запиту в чаті.

array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'PENDING',
  'order_id' => '4385323',
  'trans_id' => '28261-47789-28578',
  'trans_date' => '2020-02-25 07:12:58',
  'descriptor' => NULL,
  'hash' => '********************************',
)

Параметр	Опис

Параметр	Опис
`action`	`SALE`
`result`	`SUCCESS`
`status`	`PENDING`
`order_id`	Унікальний ордер ID транзакції в системі мерчанта
`trans_id`	Унікальний ордер ID транзакції в системі Platon
`trans_date`	Час проведення транзакції в форматі UTC (YYYY-MM-DD HH-MM-SS)
`descriptor`	NULL
`hash`	Зашифрований підпис для перевірки достовірності коллбека `md5( strtoupper( strrev(email). client_pass. trans_id ) )` Увага! Якщо в запиті на оплату не було вказано `email`, то при перевірці `sing` в підписі Callback варто вказати пусте значення `email`.

При невдалій оплаті асинхронний режим

Увага! Є випадки коли Приватбанк не повертає фінальний статус при невдалій оплаті - в такому кейсі коллбеку з фінальним статусом не буде.

array (
  'action' => 'SALE',
  'result' => 'DECLINED',
  'status' => 'DECLINED',
  'order_id' => '4092002',
  'trans_id' => '28076-29879-99538',
  'trans_date' => '2020-02-03 20:49:47',
  'decline_reason' => 'Declined by processing',
  'hash' => '********************************',
)

Параметр	Опис

Параметр	Опис
`action`	`SALE`
`result`	`DECLINED`
`status`	`DECLINED`
`order_id`	Унікальний ордер ID транзакції в системі мерчанта
`trans_id`	Унікальний ордер ID транзакції в системі Platon
`trans_date`	Час проведення транзакції в форматі UTC (YYYY-MM-DD HH-MM-SS)
`descriptor`	NULL
`decline_reason`	Причина відміни транзакції
`hash`	Зашифрований підпис для перевірки достовірності коллбека `md5( strtoupper( strrev(email). client_pass. trans_id ) )` Увага! Якщо в запиті на оплату не було вказано `email`, то при перевірці `sing` в підписі Callback варто вказати пусте значення `email`.