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

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

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

Зміст

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

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

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

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

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

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

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

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

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

HTTP METHOD: POST

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

Параметр	Значення	Опис	Особливості
`action` ОБОВ'ЯЗКОВО	`CREDITVOID`	Код платіжного метода
`client_key` ОБОВ'ЯЗКОВО	String	API ключ мерчанта	Ключ надається на пошту мерчанту
`trans_id` ОБОВ'ЯЗКОВО	String	ID транзакції Platon	ID транзакції в системе Platon
`amount` ОБОВ'ЯЗКОВО	Number	Сума повернення	Повинна бути меншою або дорівнювати сумі списання
`hash` ОБОВ'ЯЗКОВО	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);

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

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

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

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

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

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

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

Повернення

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