Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

Редірект в додаток СИНХРОННИЙ РЕЖИМ

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

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

 Проміжний Response для редіректа на сторінку Приватбанк для оформлення оплати частинами
{
  "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"
}
 Проміжний Callback для редіректа на сторінку Приватбанк для оформлення оплати частинами
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 вказано посилання по якому треба перенаправити платника для авторизації на веб сторінці Приватбанк та оформлення оплати частинами.

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

 Проміжний Response для редіректа на сторінку Приватбанк для оформлення оплати частинами
{
  "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"
}
 Проміжний Callback для редіректа на сторінку Приватбанк для оформлення оплати частинами
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',
)

При успішній оплаті СИНХРОННИЙ РЕЖИМ

 Response при успішному списанні
{
  "action":"SALE",
  "result":"SUCCESS",
  "status":"PENDING",
  "order_id":"4385302",
  "trans_id":"28261-34099-19648",
  "descriptor":null,
  "trans_date":"2020-02-25 06:50:09"
  }

Параметр

Опис

action

SALE

result

SUCCESS

status

PENDING

order_id

Унікальний ордер ID транзакції в системі мерчанта

trans_id

Унікальний ордер ID транзакції в системі Platon

trans_date

Час проведения транзакції в форматі UTC (YYYY-MM-DD HH-MM-SS)

descriptor

NULL

 Callback при успешному списанні
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.

При успішній оплаті з HOLD СИНХРОННИЙ РЕЖИМ

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

 Callback при успішній оплаті
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.

При невдалій оплаті СИНХРОННИЙ РЕЖИМ

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

 Callback при невдалому списанні
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.


Проміжна відповідь АСИНХРОННИЙ РЕЖИМ

 Response про отримання запиту на обробку
{
  "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 вказано пусте значення. Приватбанк надішле запит на оформлення оплати частинами в додаток на телефоні платника.

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

 Проміжний Callback для редіректа на сторінку Приватбанк для оформлення оплати частинами
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 вказано посилання по якому треба перенаправити платника для авторизації на веб сторінці Приватбанк та оформлення оплати частинами.

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

 Проміжний Callback для редіректа на сторінку Приватбанк для оформлення оплати частинами
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',
)

При успішній оплаті АСИНХРОННИЙ РЕЖИМ

 Callback при успешном списании
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.

При успішній оплаті з HOLD АСИНХРОННИЙ РЕЖИМ

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

 Callback при успішній оплаті
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.

При невдалій оплаті АСИНХРОННИЙ РЕЖИМ

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

 Callback при невдалому списанні
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.

  • No labels