Versions Compared

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 ключ

мерчанта

для

перевірки балансуКлюч надається на пошту мерчанту

балансу

Info

Окремий 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",
  "status":"DECLINE",
  "decline_reason":"*******"
}