Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

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

Описание:

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

Рекомендуем использовать в случае, если вы не смогли получить callback или response

API Endpoint (cсылка для отправки запросов):

Info

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


Зміст

Table of Contents

Опис

Цей метод дозволить вам проводити додаткову перевірку деталей оплати по ордеру присвоєному системою PSP Platon.

Рекомендуємо використовувати у випадку, якщо ви не змогли отримати callback або response.

Info

Запит по одному ордеру можна відправляти не частіше одного разу за хвилину.

Note

Не підходить для перевірки C2A оплат.


API параметри

HTTP METHOD: POST

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

Описание параметров запроса:

Параметр

Значение

Описание

Особенности

Обязательно

action

Параметр

Значення

Опис

Особливості

action

Status
colourGreen
titleОбов'язковий

GET_TRANS_DETAILS

Код

платежного

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

+

client_key

Status
colourGreen
titleОбов'язковий

String

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

Ключ

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

надається на

почту

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

+

trans_id

Status
colourGreen
titleОбов'язковий

String

ID

платежа

оплати в

системе

системі Platon

+

hash

hash

Status
colourGreen
titleОбов'язковий

String

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

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

Code Block
languagephp
md5(
  strtoupper(
  strrev(email).
  
client
CLIENT_
pass
PASS.
  trans_id.
  strrev(
    substr(
      card_number,0,6
).
    substr(
card_number,-4)
    )
  )
)

+

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

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

Якщо email не було вказано при оплаті, то необхідно вказати пусте значення.


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

Expand
titleПример запроса Приклад запиту на PHP
Code Block
languagephp
<?php
    $client_pass = '***';
    $action$email = 'GET_TRANS_DETAILS';
  $client_key';
    $card_number = '41111111111111111';
    $data['action'] = '***GET_TRANS_DETAILS';
  $client_pass  $data['client_key'] = '***';
   $trans $data['trans_id'] = '21151-88549-33417';
  $email = $data['';hash'] = md5(
                 $card_number = '516874******8566';   $hash = md5strtoupper(
            strtoupper(                strrev($email).
                           client $client_pass.
                            $data['trans_id'].
                            strrev(
                                substr(card$card_number,0,6).
                                substr(card$card_number,-4)
                            )
            )            );
?>
        <!DOCTYPE html> <html>   <head>     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> );
             <title>status</title>   </head>   <body onload="javascript:document.forms[0].submit()">
    <form$url action=" 'https://secure.platononline.com/post-unq/" method="post">
';
    $crq = curl_init();
     <input type="hidden" name="action" value="<?=$action?>" />
      <input type="hidden" name="client_key" value="<?=$client_key?>" />
      <input type="hidden" name="order_id" value="<?=$order_id?>" />
      <input type="hidden" name="hash" value="<?=$hash?>" />
    </form>            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;
    }
    </body>
</html>
Iframe
scrollingno
srchttps://devplaton.com.ua/invoices/postman-test.html
styleheight: 260px;
frameborderhide

Получение статуса транзакции в Response:

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

curl_close($crq);
Info

Postman Collection


Response

Expand
titleResponse при успешной проверкеуспешному запиті
Info

Параметр "status" в массиве истории данных может иметь два значения масиві історії даних може мати два значення: 0-fail, 1-success

Code Block
languagejson
{
  "action":"GET_TRANS_DETAILS",
  "result":"SUCCESS",
  "status":"SETTLED",
  ”order_id”:”343434”,
  ”trans_id”:”27920-80664-08857”,
  ”name”:”Ivan Platon”,
  ”mail”:”platon@gmail.com”,
  ”ip”:”185.175.247.151”,
  ”amount”:”1000.00”,
  ”currency”:”UAH”,
  ”card”:”12345*****6789”,
  "transactions":
    [
      {
        "date":"2012-01-01 01:10:25",
        "type":"AUTH",
        "status":"1",
        "amount":"1.95"
      },
      {
        "date":"2012-01-01 01:11:30",
        "type":"CAPTURE",
        "status":"1",
        "amount":"1.95"
      },
      {
        "date":"2012-02-06 10:25:06",
        "type":"REFUND",
        "status":"1",
        "amount":"1.95"
      }
    ]
}
Expand
titleResponse при ошибке запросапомилці запиту
Code Block
languagejson
{
  "result":"ERROR",
  "error_message":"Incorrect hash"
}