Versions Compared

Old Version 2

changes.mady.by.user Tech Platon

Saved on

compared with

New Version 3

changes.mady.by.user Tech Platon

Saved on

Key

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

Этот функционал будет доступен после подключения боевого режима и только по запросу.

Описание

Используя данный API запрос вы сможете получить актуальный баланс.

API параметры

HTTP METHOD: POST

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

Параметр

Значение

Описание

Особенности

action

Status
colourGreen
titleобязательно

GET_BALANCE

Код метода

account_key

Status
colourGreen
titleобязательно

String

API ключ мерчанта для проверки баланса

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

request_id

Status
colourGreen
titleобязательно

String

Уникальный ордер запроса

Уникальный ордер запроса на проверку баланса

hash

Status
colourGreen
titleобязательно

String

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

Code Block
languagephp
md5(
  strtoupper(
    $request_id.
    $account_key
  )
)

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

Expand
titleПример запроса на PHP
Code Block
languagephp
<?php
$url = 'https://secure.platononline.com/post-balance/';
$data['account_key'] = '*******';
$data['action'] = 'GET_BALANCE';
$data['request_id'] = Date('Ym-dH-is');
$data['hash'] = md5(strtoupper($data['request_id'] . $data['account_key']));

$post_data = http_build_query($data);
$headers = [
    "Content-Type: application/x-www-form-urlencoded",
    "Accept: application/json",
    "Content-Length: " . strlen($post_data),
];


$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4 );
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

$response = curl_exec($ch);

if (curl_errno($ch)) {
    $error[] = 'CURL ErrorNo: ' . curl_errno($ch);
    $error[] = 'CURL Error: ' . curl_error($ch);
    $error[] = 'Url: ' . $url;
    $error[] = 'Data: ' . var_export($data, true);

    echo print_r($error, true);
}

curl_close($ch);

print_r($response);

Response

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

Expand
titleResponse при успешной авторизации запроса на возвратуспешном запросе
Code Block
languagejson
{
  "action":"GET_BALANCE",
  "account_key":"*******",
  "type":"SUCCESS",
  "balance":"108.04",
  "currency":"UAH",
  "date":"2022-09-08T09:09:08+00:00"
}

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

Expand
titleResponse при неуспешной авторизации запроса на возвратнеуспешном запросе
Code Block
languagejson
{
  "action":"GET_BALANCE",
  "resultstatus":"ERRORDECLINE",
  "errordecline_messagereason":"*******"
}