Повернення

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

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

Зміст

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

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

Провести інтеграцію цього API методу.

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

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

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

Отримати 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 оплати PSP Platon
`amount` ОБов'язковий	Number	Сума повернення	Має бути меньше або рівна сумі оплати
`hash` ОБов'язковий	String	Контрольний підпис	`md5( strtoupper( strrev($email). $client_pass. $trans_id. strrev( substr($card_number,0,6). substr($card_number,-4) ) ) )`
`immediately` не ОБов'язковий	`Y`	Ознака швидкого повернення.	Без передачі цього параметра запит на поверення буде оброблятися стандартно протягом години.

<?php
  $client_pass = '***';
  $data['client_key'] = '***';
  $data['action'] = 'CREDITVOID';
  $data['trans_id'] = '19848-26243-92097';
  $data['amount'] = '85.00';
  $card = '411111******1111';
  $email = ''; // пошта з транзакції оплати, якщо була вказана
  $data['hash'] = md5(
            strtoupper(
              strrev($email).
              $client_pass.
              $data['trans_id'].
              strrev(
                substr($card,0,6).
                substr($card,-4)
              )
            )
          );
          
$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"
}

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

Повернення

Зміст

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

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

При помилці запиту: