Повернення по 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 запросом проверки:

Другие методы возвратов:

Возвраты