Повернення коштів (при розщепленні)

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

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

1 Описание
2 API параметры запроса
3 Примеры запроса
4 Проверка платежей
5 Работа с Callback
6 Callback и Response
7 Ошибки запросов

Описание

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

Возврат средств возможен только при отправке запроса с 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	Сумма возврата	Должна быть меньше или равна сумме списания	да
`split_rules`	String	Возврат и ОКПО с расщепленного платежа	Передача данных о возврате в формате JSON. Возврат может быть частичным, но в сумме равной или меньшей изначальной части платежа зачисленного на каждое ОКПО. `split_rules = { "okpo1":"amount1", "okpo2":"amount2" }`	да
`hash`	String	Контрольная подпись	`md5( strtoupper( $client_pass. $trans_id. strrev( substr($card,0,6). substr($card,-4) ) ) )`	да

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

<?php
  $client_pass = '***';
  $client_key = '***';
  $action = 'CREDITVOID';
  $trans_id = '19848-26243-92097';
  $amount = '300.00';
  $card = '41111111111111111';
  $email = '';
  $split_rules = json_encode(array('12345678' => '100.00','87654321' => '200.00'));
  $hash = md5(
            strtoupper(
              $client_pass.
              $trans_id.
              strrev(
                substr($card,0,6).
                substr($card,-4)
              )
            )
          );
          
$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, 'split_rules' => $split_rules,'hash' => $hash),
  CURLOPT_HTTPHEADER => array("Content-Type: text/html"),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Проверка платежей

Получить информацию о платежах можно несколькими способами:

Используя Callback для автоматизации процесса зачисления в системе на вашей стороне
Нотификация в Telegram Bot об успешной оплате с деталями платежа сразу после списания
В вашем личном кабинете Platon
CSV файл с деталями платежей скачав в личном кабинете Platon
Письмо об успешном платеже на почту мерчанта и / или плательщика
Банковский реестр на почту или ваш FTP
Дополнительная проверка статуса и деталей платежа по API

Работа с Callback

Callback и Response

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

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

Ошибка	Причины	Решение

Ошибка	Причины	Решение
`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 для проверки причины.