Content Comparison

Зміст

Table of Contents

maxLevel	2
indent	0px
absoluteUrl	true
style	circle

Опис

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

WarningУвага! Цей запит на виплату в цілях безпеки використовує перевірку унікальності по order_id для виключення випадків дублів запитів на видачу. У випадку відправки мерчантом декількох однакових запитів з різницею в часі від меньше 1 сек до 10 хв (що не дозволить системі за такий термін провести перевірку на унікальність) - PSP Platon не бере на себе відповідальність за відшкодування лишніх виданих коштів.

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

Провести інтеграцію API методу. Надати тех підтримці PSP Platon посилання для Callback.
Повідомити тех підтримці PSP Platon ваші IP адреса серверів для додавання в білий список. Провести виплату використовуючи тестові реквізити / реальну картку (активується після підписання договору).
Отримати Callback та / або Response.

Вимоги

Expand

title	TLS 1.2

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

API параметри

HTTP METHOD: POST

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

Параметр

Значення

Опис

Особливості

action

Status

colour	Green
title	Обов'язковий

ACCOUNT2ACCOUNT

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

client_key

Status

colour	Green
title	Обов'язковий

String

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

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

order_id

Status

colour	Green
title	Обов'язковий

String

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

Max 255 символів

order_amount

Status

colour	Green
title	Обов'язковий

Number

Сума виплати

Tip

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

1000.00

Warning

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

1000
1000.0
1,000.0
1,000.00

order_currency

Status

colour	Green
title	Обов'язковий

UAH

Валюта

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

order_description

Status

colour	Green
title	Обов'язковий

String

Опис

Max 1024 символа

senderrecipient_account_number

Status

colour	Green
title	Обов'язковий

NumberПовний

номер рахунку відправникаРахунок отримувача

16 символівrecipient

hash

Status

colour	Green
title	Обов'язковий

String

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

Code Block

language	php

md5(
  strtoupper(
    $pass.
    $orderId
  )
)

sender_account_number

Status

colour	GreenYellow
title	не Обов'язковий

NumberПовний

номер рахунку отримувачаРахунок відправника

16 символів

sender_first_name

Status

colour	GreenYellow
title	не Обов'язковий

String

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

sender_last_name

Status

colour	GreenYellow
title	не Обов'язковий

String

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

phone

Status

colour	Yellow
title	не Обов'язковий

String

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

Max 32 символи

email

Status

colour	Yellow
title	не Обов'язковий

String

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

Max 128 символів

hash

Status

colour	Green
title	Обов'язковий

String

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

code

language	php

md5(
  strtoupper(
    $pass.
    $orderId
  )
)

sender_taxn

Status

colour	GreenYellow
title	не Обов'язковий

String

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

channel_id

Status

colour	Yellow
title	не Обов'язковий

String

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

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

req_token

Status

colour	Yellow
title	не Обов'язковий

Y

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

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

Include PageТестові реквізити (IA, A2C)Тестові реквізити (IA, A2C)

Перевірка виплати

Expand

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

Code Block

language	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',
 
  'channel_id' => '',
    '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);

Info
Postman Collection

Тестування

Expand

title	Використайте наші тестові реквізити

Отримання результату транзакції

Expand

title	Список методів для перевірки результату транзакції

Include Page

Отримання результату транзакції

Callback та Response

Expand

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

Include Page

	Робота з Callback
	Робота з Callback

Expand

title	Безпека

Include Page

	Безпека
	Безпека

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

Зашифрованный токен карты для последующих транзакций по card_token

Expand

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

Code Block

language	php

array (
  'action' => 'CREDIT2CARD',
  'result' => 'SUCCESS',
  'status' => 'SETTLED',
  'order_id' => '1328876',
  'trans_id' => '27894-89059-67608',
  'trans_date' => '2020-01-13 20:55:05',
  'hash' => '********************************',
  'card_hash' => 'cc1c30cfbfe57b068b1f6c4c336791282256b2efc8cf52e85cc2e5fa2a62047a',
  'fee_type' => 'TRANSACTION',
  'fee' => '0.5',
)

Info
Для проверки достоверности полученного callback, рекомендуем сверять подпись hash по формуле md5(strtoupper(client_pass.trans_id.strrev(substr(card_number,0,6).substr(card_number,-4))))

Параметр

Описание

action

CREDIT2CARD

result

SUCCESS

status

SETTLED

order_id

Уникальный ордер ID транзакции в системе мерчанта

trans_id

Уникальный ордер ID транзакции в системе Platon

trans_date

Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)

card_token

card_hash

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

Этот параметр даст вам возможность в вашей системе:

Привязать карту под клиента.
Проверить не использовал ли другой клиент эту же карту.
Проверить какие кредиты, товары и услуги погашаются данной картой.
Отслеживать мошенничество, когда клиент использует ту же карту с другого аккаунта, например, чтобы повторно воспользоваться акцией.

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

fee_type

Признак каким образом взимается комиссия:

ACT - по актам.
TRANSACTION - потранзакционно.

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

fee

Сумма комиссии с мерчанта по транзакции в ГРН

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

hash

Зашифрованная проверочная подпись

Expand

title	Response при успешной выплате

Code Block

language	json

{
  "action":"CREDIT2CARDACCOUNT2ACCOUNT",
  "result":"SUCCESS",
  "status":"SETTLED",
  "order_id":"1328876202409-3005-3126",
  "trans_id":"2789442767-8905942869-6760817204",
  "trans_date":"20202024-0109-1330 2005:5531:0526"
}

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

Expand

title	Callback при невдалій виплаті

Code Block

language	php

array (
  'action' => 'CREDIT2CARD',
  'result' => 'DECLINED',
  'status' => 'DECLINED',
  'order_id' => '560404',
  'trans_id' => '27894-80158-07868',
  'trans_date' => '2020-01-13 20:40:15',
  'decline_reason' => '9858: Restricted Card',
  'hash' => '********************************',
  'card_hash' => '31c9ea919afdc5361ca31cc9e3c4874af6bdd374601e7ef8e6c72b3d9ef0933f',
)

Info
Для проверки достоверности полученного callback, рекомендуем сверять подпись hash по формуле md5(strtoupper(client_pass.trans_id.strrev(substr(card_number,0,6).substr(card_number,-4))))

Параметр

Описание

action

CREDIT2CARD

result

DECLINED

status

DECLINED

order_id

Уникальный ордер ID транзакции в системе мерчанта

trans_id

Уникальный ордер ID транзакции в системе Platon

trans_date

Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)

card_token

Зашифрованный токен карты для последующих транзакций по card_token

decline_reason

Причина отмены транзакции

hash

Зашифрованная проверочная подпись

Expand

title	Response при невдалій виплаті

Code Block

language	json

{
  "action":"CREDIT2CARDACCOUNT2ACCOUNT",
  "result":"DECLINEDFAILED",
  "status":"DECLINED",
  "order_id":"560404202410-0313-1741",
  "trans_id":"2789442796-8015814628-0786832464",
  "trans_date":"20202024-0110-03 13 20:4017:1542",
  "decline_reason":"9858:Declined Restrictedby Card"
}

Проміжна відповідь у випадку технічних негараздів:

Expand

title	Проміжний Callback у випадку технічних негараздів

Note

При отриманні Callback з таким статусом необхідно очікувати Callback з фінальним статусом транзакції.

Симулювати такий Callback в тестовому середовищі неможливо.

Code Block

language	php

array (
  'action' => 'CREDIT2CARDTOKEN',
  'result' => 'SUCCESS',
  'status' => 'WAITING',
  'order_id' => '5774734',
  'trans_id' => '28262-75863-96848',
  'trans_date' => '2020-02-25 10:46:26',
  'hash' => '********************************',
)

Info
Для проверки достоверности полученного callback, рекомендуем сверять подпись hash по формуле md5(strtoupper(client_pass.trans_id.strrev(substr(card_number,0,6).substr(card_number,-4))))

Параметр

Описание

action

CREDIT2CARD

result

SUCCESS

status

WAITING

order_id

Уникальный ордер ID транзакции в системе мерчанта

trans_id

Уникальный ордер ID транзакции в системе Platon

trans_date

Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)

card_token

Зашифрованный токен карты для последующих транзакций по card_token

hash

Зашифрованная проверочная подпись

Expand

title	Проміжний Response у випадку технічних негараздів

Note

При отриманні Response з таким статусом необхідно очікувати Response з фінальним статусом транзакції.

Симулювати такий Response в тестовому середовищі неможливо.

Code Block

language	json

{
  "action":"CREDIT2CARDTOKEN",
  "result":"SUCCESS",
  "status":"WAITING",
  "order_id":"5774734",
  "trans_id":"28262-75863-96848",
  "trans_date":"2020-02-25 10:46:26"
}

Помилки при виплатах

Expand

title	Коди помилок та варіанти вирішень при A2C виплатах на картку

Include PageПомилки та рішення при A2C виплаті на карткуПомилки та рішення при A2C виплаті на картку

Помилки запитів

Помилки та рішення при запитах

Expand

title	Список помилок та варіантів рішень

Include Page

Помилки та рішення при запитах

processing"
}

Version	Old Version 1	New Version Current
Changes made by	Tech Platon	Tech Platon
Saved on	Sept 25, 2024	Oct 03, 2024

Versions Compared

Key

Зміст

Опис

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

Вимоги

API параметри

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

Перевірка виплати

Тестування

Callback та Response

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

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

Проміжна відповідь у випадку технічних негараздів:

Помилки при виплатах

Помилки запитів