Повернення при оплаті частинами

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

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

Зміст

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

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

Провести інтеграцію цього 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( $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 перевірки:

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

Повернення

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