A2A переказ

Зміст

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

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

Вимоги

TLS 1.2

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

API параметри

HTTP METHOD: POST

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

Параметр	Значення	Опис	Особливості
`action` ОБОВ'ЯЗКОВИЙ	`ACCOUNT2ACCOUNT`	Код платіжного метода
`client_key` ОБОВ'ЯЗКОВИЙ	String	API ключ мерчанта	Ключ надається на пошту мерчанту
`order_id` ОБОВ'ЯЗКОВИЙ	String	Унікальний ордера мерчанта	Max 255 символів
`order_amount` ОБОВ'ЯЗКОВИЙ	Number	Сума виплати	Вірний варіант 1000.00 Невалідні варіанти 1000 1000.0 1,000.0 1,000.00
`order_currency` ОБОВ'ЯЗКОВИЙ	`UAH`	Валюта	Виплата можлива лише в національній валюті гривні.
`order_description` ОБОВ'ЯЗКОВИЙ	String	Опис	Max 1024 символа
`recipient_account_number` ОБОВ'ЯЗКОВИЙ	Number	Рахунок отримувача	16 символів
`hash` ОБОВ'ЯЗКОВИЙ	String	Контрольний підпис	md5( strtoupper( $pass. $orderId ) )
`sender_account_number` НЕ ОБОВ'ЯЗКОВИЙ	Number	Рахунок відправника	16 символів
`sender_first_name` НЕ ОБОВ'ЯЗКОВИЙ	String	Ім'я відправника
`sender_last_name` НЕ ОБОВ'ЯЗКОВИЙ	String	Прізвище отримувача
`phone` НЕ ОБОВ'ЯЗКОВИЙ	String	Телефон відправника	Max 32 символи
`email` НЕ ОБОВ'ЯЗКОВИЙ	String	Валідний емейл відправника	Max 128 символів
`sender_taxn` НЕ ОБОВ'ЯЗКОВИЙ	String	ІПН відпраника
`channel_id` НЕ ОБОВ'ЯЗКОВИЙ	String	Додатковий платіжний канал	Дозволяє використати інший банківський термінал
`req_token` НЕ ОБОВ'ЯЗКОВИЙ	`Y`	Створення токену

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

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

<?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

Особливості роботи з Callback

URL для Callback

Для отримання Callback відправте URL на ваш обробник в груповий чат з вказанням API ключа для якого потрібно прописати посилання. Посилання для Callback вказується на боці PSP Platon.

Очікувана відповідь на Callback

Після відправки Callback у відповідь PSP Platon має отримати HTTP код 200.

Помилки при відправці Callback

Якщо Callback не вдалося відправити або було отримано не HTTP код 200, будуть проведені додаткові повторні спроби відправки в проміжках часу 1 хв, 5 хв, 10 хв, 15 хв, 30 хв, 60 хв.

Перевідправка Callback

Для перевідправки Callback прохання повідомити в груповий чат список необхідних ордерів.

Безпека

Увага! Рекомендації цього розділу допоможуть забезпечити безпеку від шахрайських дій пов'язаних з вашим сайтом та транзакціями.

Секретність API доступів

Не тримайте у відкритому доступі API ключ та API пароль, а також не надавайте обидва ці параметри в групові робочі чати, в тому числі з нами. Для перевірки деталей представники PSP Platon можуть попросити у вас лише API ключ, пароль треба тримати в таємниці.

Секретність кабінету

Не розголошуйте логін та пароль від вашого особистого кабінету третім особам. У випадку якщо доступ був втрачений зверніться в груповий чат. Пароль від особистого кабінету діє 30 днів. Рекомендуємо оновлювати пароль до закінчення терміну дії в 30 днів.

Секретність посилання для Callback

Не залишайте посилання для Callback у відкритому доступі на вашому ресурсі.

Сторінка успішної оплати не гарантія успіху оплати

Не використовуйте факт переходу платника на сторінку успішної оплати як признак успішної оплати. Статус транзакції та деталі оплати необхідно отримати тільки в Callback або в особистому кабінеті PSP Platon.

Звірка даних в Callback

При отриманні від нас Callback про успішну оплату рекомендуємо проводити на вашому боці додаткову перевірку суми та ордера з Callback на відповідність початкової суми та ордера у вашій базі даних, які були вказані при створенні замовлення.

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

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

{
  "action":"ACCOUNT2ACCOUNT",
  "result":"SUCCESS",
  "status":"SETTLED",
  "order_id":"202409-3005-3126",
  "trans_id":"42767-42869-17204",
  "trans_date":"2024-09-30 05:31:26"
}