Content Comparison

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

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

Содержание

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

Зміст

Table of Contents

maxLevel	2
minLevel	1
include
outline	false
indent	0px

absoluteUrl

exclude

true


style	circle

Описание

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


type	list
printable	false
class

Опис

Цей метод дозволяє повернути платнику його грошові кошти при оплаті частинами Monobank.

Warning
Внимание! Возврат производится в полном обьеме суммы кредитаУвага! Повернення необхідно проводити в повному обсязі.

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

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

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

Требования

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

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

Провести інтеграцію цього API методу.
Повідомити тех підтримці PSP Platon посилання для Callback (якщо раніше не було вказано).
Повідомити тех підтримці PSP Platon ваші IP адреси серверів сайту або про те, що буде використовуватись додаток (в цьому випадку обмеження по IP будуть зняті).
Після успішної оплати провести запит на повернення.
Отримати 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

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

оплати PSP 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(
    $pass.
    $trans_id
  )
)

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

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

Expand

title	Пример запроса Приклад запиту на PHP

Code Block

language	php

<?php
  $client_pass = '***';
  $data['client_key'] = '***';
  $data['action'] = 'CREDITVOID';
  $data['trans_id'] = '19848-26243-92097';
  $data['amount'] = '85.00';
  $data['hash'] = md5(
                    strtoupper(
                      $pass$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 => $data,
));

$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($curl$crq);
  if (curl_errno($crq)) {
    echo 'ERROR: '.curl_closeerror($curl$crq);
  }else{
    echo $response; $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' => '27860-50312-05387',
  'order' => '27860-49622-7227',
  'status' => 'REFUND',
  'rrn' => NULL,
  'approval_code' => NULL,
  'card' => '**************',
  'description' => 'Оплата',
  'amount' => '500.00',
  'currency' => 'UAH',
  'name' => ' ',
  'email' => NULL,
  'country' => NULL,
  'state' => NULL,
  'city' => NULL,
  'address' => NULL,
  'date' => '2020-01-09 21:23:51',
  'ip' => '46.133.140.32',
  'sign' => '********************************'
)

Info

Для проверки достоверности полученного перевірки достовірності отриманого callback, рекомендуем сверять подпись sign по формуле рекомендуємо звіряти підпис sign за формулою md5(strtoupper(strrev(email).client_pass.order.strrev(substr(card,0,6).substr(card,-4)))).

ВниманиеУвага! Если Якщо при запросе запиті на оплату не был указан було вказано email, то при проверке sing в подписи коллбека следует указать пустое значение під час перевірки sing у підписі колбека слід вказати порожнє значення для email.

Expand

title	Callback при успешном ПОЛНОМ возврате при оплате по протоколу успішному ПОВНОМУ поверненні при оплаті за протоколом https://secure.platononline.com/post-unq/

Info
Callback отправляется через час после успешной авторизациивідправляється за годину після успішної авторизації

Code Block

language	php

array (
  'action' => 'CREDITVOID',
  'result' => 'SUCCESS',
  'status' => 'REFUND',
  'order_id' => '7428404',
  'trans_id' => '30009-01494-16697',
  'amount' => '97.00',
  'creditvoid_date' => '2020-09-15 07:30:16',
  'hash' => '********************************',
)

Info

Для проверки достоверности полученного перевірки достовірності отриманого callback, рекомендуем сверять подпись sign по формуле рекомендуємо звіряти підпис sign за формулою md5(strtoupper(strrev(email).client_pass.trans_id.strrev(substr(card,0,6).substr(card,-4)))).

ВниманиеУвага! Если Якщо при запросе запиті на оплату не был указан було вказано email, то при проверке sing в подписи коллбека следует указать пустое значение під час перевірки sing у підписі колбека слід вказати порожнє значення для email.

Expand

title	Callback при успешном ЧАСТИЧНОМ возврате при оплате по протоколу успішному ЧАСТИЧНОМУ поверненні при оплаті за протоколом https://secure.platononline.com/post-unq/

Info
Callback отправляется через час после успешной авторизациивідправляється за годину після успішної авторизації

Code Block

language	php

array (
  'action' => 'CREDITVOID',
  'result' => 'SUCCESS',
  'status' => 'SETTLED',
  'order_id' => '7428404',
  'trans_id' => '30009-01494-16697',
  'amount' => '97.00',
  'creditvoid_date' => '2020-09-15 07:30:16',
  'hash' => '********************************',
)

Info

Для проверки достоверности полученного перевірки достовірності отриманого callback, рекомендуем сверять подпись sign по формуле рекомендуємо звіряти підпис sign за формулою md5(strtoupper(strrev(email).client_pass.trans_id.strrev(substr(card,0,6).substr(card,-4)))).

ВниманиеУвага! Если Якщо при запросе запиті на оплату не был указан було вказано email, то при проверке sing в подписи коллбека следует указать пустое значение під час перевірки sing у підписі коллбека слід вказати порожнє значення для email.

При

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

помилці запиту:

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 07, 2025

Versions Compared

Key

Зміст

Описание

Опис

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

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

Вимоги

API

параметри

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

Callback и Response

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

При

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

При

помилці запиту:

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

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

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

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

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

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