Versions Compared

Key

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

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

Table of Contents

Описание:

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

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

Note

Не подходит для проверки статуса оплаты по Дебетовое погашение и Дебетовое погашение по CARD_TOKEN

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

Info

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


Зміст

Table of Contents

Опис

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

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

Info

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

Note

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


API параметри

HTTP METHOD: POST

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

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

Параметр

Значение

Описание

Особенности

Обязательно

action

Параметр

Значення

Опис

Особливості

action

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

GET_TRANS_STATUS_BY_ORDER

Код

платежного

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

Да

client_key

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

String

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

Ключ

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

надається на пошту мерчанта

order_id

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

String

ID

платежа

оплати в

системе

системі мерчанта

Note

Ордер не

должен содержать

має містити 16 цифр

подряд

Да

hash

підряд

hash

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

String

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

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

Code Block
languagephp
md5(
  strtoupper(
    client_pass.
    order_id
  )
)

Да

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

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


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

Expand
titleПример запроса Приклад запиту на PHP
Code Block
languagephp
<?php
   $action $client_pass = '***';
    $data['action'] = 'GET_TRANS_STATUS_BY_ORDER';
  $client_pass = '***';
  $client$data['client_key'] = '***';
  $order  $data['order_id'] = 'order-1521731596';
    $hash$data['hash'] = md5(
                        strtoupper(
                            $client_pass.
                      $order_id      $data['order_id']
      )           ); ?>  <!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();
    curl_setopt($crq, CURLOPT_URL, $url);
     <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>
  </body>
</html>
Iframe
scrollingno
srchttps://devplaton.com.ua/invoices/postman-test.html
styleheight: 260px;
frameborderhide

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

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

Response при успешной проверке
Expand
title
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


Response

Expand
titleResponse при успешній перевірці
Code Block
languagejson
{
  "action":"GET_TRANS_STATUS_BY_ORDER",
  "result":"SUCCESS",
  "orders":
    [
      {
        "date":"2019-10-30 08:36:23",
        "status":"SETTLED",
        "order_id":"1924820810562 : 3307318487_191030-103026",
        "amount":"1000.00",
        "trans_id":"27242-45834-68448"
      }
    ]
}
Expand
titleResponse при ошибке запросапомилці запиту
Code Block
languagejson
{
  "result":"ERROR",
  "error_message":"Incorrect hash"
}