Page Comparison

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

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

Table of Contents

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

Содержание

Table of Contents

maxLevel	2
minLevel	1
indent	0px
absoluteUrl	true
style	circle

Описание

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

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

API параметры запроса

HTTP METHOD: StatuscolourGreentitle

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

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

Требования

Expand

title	TLS 1.2

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

API параметры

HTTP METHOD: POST

API ENDPOINT: https://secure.platononline.com/post-unq/

Параметр

Значение

Описание

Особенности

Обязательно

actionclient_key

action

Status

colour	Green
title	обязательно

CREDITVOID

Код платежного метода

client_key

Status

title
colour	Green

Даtrans_id

обязательно

String

API ключ мерчанта

Ключ предоставляется на почту мерчанту

trans_id

Status

title
colour	Green

Да

обязательно

String

ID транзакции Platon

ID транзакции в системе Platon

amount

Status

title
colour	Green

Даamount

обязательно

Number

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

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

Tip

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

1000.00

Warning

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

1000
1000.0
1,000.0
1,000.00

hash

Status

title
colour	Green

Да

обязательно

hash

String

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

Code Block

language	php

md5(
  strtoupper(
    $client_pass.
    $trans_id
  )
)

status

colour	Green
title	Да

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

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

Expand

title	Пример запроса на PHP

Code Block

language	php

<?php
  $client_pass = '***';
  $client$data['client_key'] = '***';
  $action$data['action'] = 'CREDITVOID';
  $trans$data['trans_id'] = '19848-26243-92097';
  $amount$data['amount'] = '85.00';
  $card = '41111111111111111';
  $email = '';
  $hash$data['hash'] = md5(
            strtoupper(
              $client_pass.
              $trans$data['trans_id']
            )
          );
          
$curl$url = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "'https://secure.platononline.com/post-unq/",';
$crq = 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;

Iframe

scrolling	no
src	https://devplaton.com.ua/invoices/postman-test.html
style	height: 260px;
frameborder	hide

Работа с Callback

Info

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

Callback и Response

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

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);

Info
Postman Collection

Callback и Response

Expand

title	Особенности работы с Callback

Include Page

	Робота з Callback
	Робота з Callback

Expand

title	Безопасность

Include Page

	Безпека
	Безпека

Промежуточный ответ:

Expand

title	Response при успешной авторизации запроса на возврат

Code Block

language	json

{
  "action":"CREDITVOID",
  "result":"ACCEPTED",
  "order_id":"27859-52747-0554",
  "trans_id":"27859-54289-00657"
}

При успешном возврате:

Expand

title	Callback при успешном возврате при оплате по протоколу https://secure.platononline.com/payment/auth

Info
Callback отправляется через час после успешной авторизации

Code Block

language	php

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',
)

При ошибке запроса:

Expand

title	Response при неуспешной авторизации запроса на возврат

Code Block

language	json

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

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

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

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

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

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

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

Expand

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

Ошибка

Причины

Решение

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.

, их причин и возможных решений.

Include Page

	Помилки та рішення при запитах
	Помилки та рішення при запитах

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

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

Возвраты

Versions Compared

Old Version 3

New Version Current

Key

Содержание

Описание

API параметры запроса

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

Требования

API параметры

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

Работа с Callback

Callback и Response

Callback и Response

Промежуточный ответ:

При успешном возврате:

При ошибке запроса:

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

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

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

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