Повернення по Privat24

Цей функціонал буде активовано після вашого запиту в груповому чаті.

Запит на повернення необхідно проводити виключно не менше ніж через 10 хвилин після отримання коллбека про успішний платіж. В іншому разі буде помилка.

Зміст

1 Зміст
2 Опис
3 Чеклист інтеграції
4 Вимоги
5 API параметри
6 Приклади запиту
7 Callback та Response
8 Додаткова перевірка повернення
9 Помилки запитів
10 Пов'язані розділи

Опис

Цей метод дає змогу повернути платнику грошові кошти під час оплати по Privat24.

Повернення коштів можливе тільки в разі надсилання запиту з API ключа та юр. особи, що були використані для оплати.

Чеклист інтеграції

Інтегрувати запит згідно з даним API.

Передати техпідтримці PSP Platon посилання для Callback (якщо раніше не було вказано).

Повідомити в техпідтримку PSP Platon ваші IP-адреси сервера сайту або про те, що буде використовуватися застосунок (у цьому разі обмеження за IP буде знято).

Після успішної оплати Privat24 реальною карткою провести запит на повернення.

Отримати Callback і Response.

Відобразити платнику на сайті / додатку повернення коштів.

Вимоги

Необхідна підтримка протоколу TLS не нижче версії 1.2

API параметри

HTTP METHOD: POST

API ENDPOINT: https://secure.platononline.com/post-unq/

Параметр	Значення	Опис	Особливості
`action` status:ОБОВ'ЯЗКОВО	`CREDITVOID`	Код платіжного метода
`client_key` status:ОБОВ'ЯЗКОВО	String	API ключ мерчанта	Ключ надається на пошту мерчанту
`trans_id` status:ОБОВ'ЯЗКОВО	String	ID транзакції Platon	ID транзакції в системе Platon
`amount` status:ОБОВ'ЯЗКОВО	Number	Сума повернення	Повинна бути меншою або дорівнювати сумі списання Правильний варіант 1000.00 Неправильні варіанти 1000 1000.0 1,000.0 1,000.00
`hash` status:ОБОВ'ЯЗКОВО	String	Контрольний підпис	`md5( strtoupper( $client_pass. $trans_id ) )`

Приклади запиту

<?php
  $client_pass = '***';
  $data['client_key'] = '***';
  $data['action'] = 'CREDITVOID';
  $data['trans_id'] = '19848-26243-92097';
  $data['amount'] = '85.00';
  $data['hash'] = md5(
            strtoupper(
              $client_pass.
              $data['trans_id']
            )
          );
          
$url = 'https://secure.platononline.com/post-unq/';
$crq = curl_init();
curl_setopt($crq, CURLOPT_URL, $url);
curl_setopt($crq, CURLOPT_HEADER, 0);
curl_setopt($crq, CURLOPT_POST, 1);
curl_setopt($crq, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($crq, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($crq, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($crq, CURLOPT_POSTFIELDS, http_build_query($data));
$result = curl_exec($crq);
  if (curl_errno($crq)) {
    echo 'ERROR: '.curl_error($crq);
  }else{
    echo $result;
  }
curl_close($crq);

Postman Collection

Callback та Response

Проміжна відповідь:

{
  "action":"CREDITVOID",
  "result":"ACCEPTED",
  "order_id":"27859-52747-0554",
  "trans_id":"27859-54289-00657"
}

При успішному поверненні:

Callback надсилається через годину після успішної авторизації

array (
  'id' => '31192-15588-09364',
  'order' => '31192-15548-3658',
  'status' => 'REFUND',
  'description' => 'Test_by_Platon',
  'amount' => '34.12',
  'currency' => 'UAH',
  'date' => '2021-01-29 11:59:18',
  'ip' => '178.158.192.219',
  'sign' => '********************************',
  'number' => '516875*74',
  'email' => NULL,
  'name' => ' ',
  'phone' => '380967904334',
)

У разі помилки запиту:

{
  "result":"ERROR",
  "error_message":"Transaction already refunded"
}

Додаткова перевірка повернення

Для отримання інформації про повернення в разі, якщо ваша система не змогла прийняти Callback, Response або з іншої причини, можна скористатися додатковим API запитом перевірки:

Помилки запитів

Пов'язані розділи

Інші методи повернень:

Повернення

Документація