Content Comparison

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

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

Содержание

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

Зміст

Table of Contents

maxLevel	2
minLevel	1
indent	0px
absoluteUrl	true
style	circle

Описание

Опис

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

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

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

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

Требования

Повернення коштів можливе тільки в разі надсилання запиту з API ключа та юр. особи, що були використані для оплати.

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

Інтегрувати запит згідно з даним 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/

Параметр

Значение

Значення

Описание

Опис

Особенности

Особливості

action

Status

title
colour	Green

обязательно

ОБОВ'ЯЗКОВО

CREDITVOID

Код

платежного

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

client_key

Status

title
colour	Green

обязательно

ОБОВ'ЯЗКОВО

String

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

Ключ

предоставляется

надається на

почту

пошту мерчанту

trans_id

Status

title
colour	Green

обязательно

ОБОВ'ЯЗКОВО

String

ID

транзакции

транзакції Platon

ID

транзакции

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

amount

Status

title
colour	Green

обязательно

ОБОВ'ЯЗКОВО

Number

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

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

Сума повернення

Повинна бути меншою або дорівнювати сумі списання

Tip

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

Правильний варіант

1000.00

Warning

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

Неправильні варіанти

1000
1000.0
1,000.0
1,000.00

hash

Status

title
colour	Green

обязательно

ОБОВ'ЯЗКОВО

String

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

Контрольний підпис

Code Block

language	php

md5(
  strtoupper(
    $client_pass.
    $trans_id
  )
)

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

Приклади запиту

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,
 curl_init();
curl_setopt($crq, CURLOPT_ENCODING => "",
 URL, $url);
curl_setopt($crq, 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 и Response

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

Expand

title

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

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

або з іншої причини, можна скористатися додатковим API запитом перевірки:

Помилки запитів

Expand

title	Список ошибокпомилок, их причин и возможных решенийїхніх причин і можливих рішень.

Include Page

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

Version	Old Version 6	New Version Current
Changes made by	Tech Platon	Tech Platon
Saved on	May 15, 2023	Jan 15, 2025

Versions Compared

Key

Зміст

Опис

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

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

Вимоги

API

параметри

Приклади запиту

Callback и Response

Callback та Response

Проміжна відповідь:

При

успішному поверненні:

У разі помилки запиту:

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

Додаткова перевірка повернення

Помилки запитів

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

Пов'язані розділи

Інші методи повернень: