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

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

note

Содержание

Содержание

note

Описание

Описание

Данный метод позволяет вернуть плательщику денежные средства при оплате по Privat24.

Возврат средств возможен только при отправке запроса с API ключа и юр. лица, что были использованы для оплаты.

note

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

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

  • Интегрировать запрос согласно данного API.
  • Передать тех поддержке PSP Platon ссылку для Callback (если ранее не было указано).
  • Сообщить в тех поддержке PSP Platon ваши IP адреса сервера сайта или о том, что будет использоваться приложение (в этом случае ограничения по IP будут сняты).
  • После успешной оплате Privat24 реальной картой провести запрос на возврат.
  • Получить Callback и Response.
  • Отобразить плательщику на сайте / приложении возврат средств.
note

Требования

Требования

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

note

API параметры

API параметры

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

Сумма возврата

Должна быть меньше или равна сумме списания

Верный вариант

1000.00

Неверные варианты

1000
1000.0
1,000.0
1,000.00

hash

String

Контрольная подпись

md5(
  strtoupper(
    $client_pass.
    $trans_id
  )
)
note

Примеры запроса

Примеры запроса

<?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

note

Callback и Response

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

note

Ошибки запросов

Ошибки запросов

note

Связанные разделы

Связанные разделы

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