Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

Этот функционал будет активирован после вашего запроса в групповом чате. Также обязательно сообщите IP адреса, с которых будут отправляться запросы для добавления в белый список.

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

Ваш сайт должен работать по схеме HTTPS и поддерживать протокол TLS 1.2.

Описание

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

Возврат средств возможен только при отправке запроса с 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
  )
)

ДА

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

Для просмотра примера раскройте список

 Пример запроса на PHP
<?php
  $client_pass = '***';
  $client_key = '***';
  $action = 'CREDITVOID';
  $trans_id = '19848-26243-92097';
  $amount = '85.00';
  $card = '41111111111111111';
  $email = '';
  $hash = md5(
            strtoupper(
              $client_pass.
              $trans_id
            )
          );
          
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://secure.platononline.com/post-unq/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => array('action' => 'CREDITVOID','client_key' => $client_key, 'trans_id' => $trans_id,'amount' => $amount,'hash' => $hash),
  CURLOPT_HTTPHEADER => array("Content-Type: text/html"),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Работа с Callback

Рекомендуем ознакомиться с разделами:

Callback и Response

Для просмотра примера раскройте список

 Response при успешной авторизации запроса на возврат
{
  "action":"CREDITVOID",
  "result":"ACCEPTED",
  "order_id":"27859-52747-0554",
  "trans_id":"27859-54289-00657"
}
 Callback при успешном возврате при оплате по протоколу https://secure.platononline.com/payment/auth

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',
)
 Response при неуспешной авторизации запроса на возврат
{
  "result":"ERROR",
  "error_message":"Transaction already refunded"
}

Дополнительная проверка возврата

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

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

В ходе проведения запрос вы можете получить разные ошибки. Пожалуйста, ознакомьтесь со списком возможных ошибок, их причин и возможности решения.

Для просмотра примера раскройте список

 Список ошибок и их решение

Ошибка

Причины

Решение

Response: {"result":"ERROR","error_message":"Account error"}

Ваш IP адрес не добавлен в наш белый список.

Обратитесь в тех поддержку для добавления вашего IP в белый список.

Данный функционал вам не подключен.

Обратитесь в тех поддержку для активации функционала.

Запрос отправлен не на нужную ссылку.

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

Response: {"result":"ERROR","error_message":"Incorrect hash"}

Неверно сформирована зашифрованная подпись.

Проверьте верность сформированной подписи. Если ошибку не нашли обратитесь в тех поддержку.

Добавлены параметры, которые не входят в данный запрос.

Проверьте список передаваемых параметров. Если ошибку не нашли обратитесь в тех поддержку.

Response: {"result":"ERROR","error_message":"Transaction already refunded"}

По данной транзакции ранее уже был выполнен возврат.

Возврат по данной операции проводить не нужно.

Response: {"result":"ERROR","error_message":"Empty action"}

Параметр action заполнен не верно, пуст, или не на первом месте в списке параметров запроса.

Проверьте список передаваемых параметров. Если ошибку не нашли обратитесь в тех поддержку.

Response: {"result":"ERROR","error_message":"Duplicate request"}

За одну минуту в систему вами было отправлено несколько одинаковых запросов.

Рекомендуем проверить ваш механизм отправки запросов на наличие задвоения.

Response: {"result":"ERROR","error_message":"Service error"}

Ситуация требует внимания сотрудников Platon.

Рекомендуем обратиться в тех саппорт Platon для проверки причины.

  • No labels