Versions Compared

Key

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

Зміст

Table of Contents
maxLevel2
indent0px
absoluteUrltrue
stylecircle

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

  •  Провести інтеграцію API методу.
  •  Повідомити тех підтримці PSP Platon ваші IP адреса серверів для додавання в білий список.
  •  Отримати Response.

Вимоги

Expand
titleTLS 1.2

Необхідна підтримка протоколу TLS не нижче версії 1.2


API параметри

HTTP METHOD: POST

API ENDPOINT: https://secure.platononline.com/a2a/

Параметр

Значення

Опис

Особливості

action

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

ACCOUNT2ACCOUNT

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

client_key

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

String

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

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

order_id

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

String

Унікальний ордера мерчанта

Max 255 символів

order_amount

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

Number

Сума виплати

Tip

Вірний варіант

1000.00

Warning

Невалідні варіанти

1000
1000.0
1,000.0
1,000.00

order_currency

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

UAH

Валюта

Info

Виплата можлива лише в національній валюті гривні.

order_description

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

String

Опис

Max 1024 символа

recipient_account_number

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

Number

Рахунок отримувача

16 символів

hash

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

String

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

Code Block
languagephp
md5(
  strtoupper(
    $pass.
    $orderId
  )
)

sender_account_number

Status
colourYellow
titleне Обов'язковий

Number

Рахунок відправника

16 символів

sender_first_name

Status
colourYellow
titleне Обов'язковий

String

Ім'я відправника

sender_last_name

Status
colourYellow
titleне Обов'язковий

String

Прізвище отримувача

phone

Status
colourYellow
titleне Обов'язковий

String

Телефон відправника

Max 32 символи

email

Status
colourYellow
titleне Обов'язковий

String

Валідний емейл відправника

Max 128 символів

sender_taxn

Status
colourYellow
titleне Обов'язковий

String

ІПН відпраника

channel_id

Status
colourYellow
titleне Обов'язковий

String

Додатковий платіжний канал

Дозволяє використати інший банківський термінал

req_token

Status
colourYellow
titleне Обов'язковий

Y

Створення токену


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

Expand
titleПриклад запиту на PHP
Code Block
languagephp
<?php
$url = 'https://secure.platononline.com/a2a/';
$key = '***';
$pass = '********';
$orderId = Date('Ym-dH-is');

  $data = [
    'client_key' => $key,
    'action' => 'ACCOUNT2ACCOUNT',
    'order_id' => $orderId,
    'order_amount' => '1.00',
    'order_currency' => 'UAH',
    'order_description' => 'TEST ACCOUNT TRANSACTION',
    'sender_account_number' => '11111111111111111111',
    'recipient_account_number' => '22222222222222222222',
    'sender_first_name' => 'Kostiantyn',
    'sender_last_name' => 'Korolev',
    'phone' => '0509102155',
    'email' => 'test@gmail.com',
    'sender_taxn' => '333333',
    'req_token' => 'N',
    'ext1' => 'ext1',
    'ext2' => 'ext2',
    'ext3' => 'ext3',
    'ext4' => 'ext4',
    'ext5' => 'ext5',
    'ext6' => 'ext6',
    'ext7' => 'ext7',
    'ext8' => 'ext8',
    'ext9' => 'ext9',
    'ext10' => 'ext10',
    'hash' => md5(strtoupper($pass.$orderId)),
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
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: ' . $data;

    echo print_r($error, true);
}

curl_close($ch);

print_r($response);

Callback та Response

Expand
titleОсобливості роботи з Callback
Include Page
Робота з Callback
Робота з Callback
Expand
titleБезпека
Include Page
Безпека
Безпека

При успішній виплаті:

Expand
titleResponse при успішній виплаті
Code Block
languagejson
{
  "action":"ACCOUNT2ACCOUNT",
  "result":"SUCCESS",
  "status":"SETTLED",
  "order_id":"202409-3005-3126",
  "trans_id":"42767-42869-17204",
  "trans_date":"2024-09-30 05:31:26"
}

При невдалій виплаті:

Expand
titleResponse при невдалій виплаті
Code Block
languagejson
{
  "action":"ACCOUNT2ACCOUNT",
  "result":"FAILED",
  "status":"DECLINED",
  "order_id":"202410-0313-1741",
  "trans_id":"42796-14628-32464",
  "trans_date":"2024-10-03 13:17:42",
  "decline_reason":"Declined by processing"
}