| Info |
|---|
Этот функционал будет активирован после вашего запроса в групповом чате. |
Цей функціонал буде активовано після вашого запиту в груповому чаті. |
| Table of Contents |
|---|
| maxLevel | 2 |
|---|
| indent | 0px |
|---|
| absoluteUrl | true |
|---|
| style | circle |
|---|
|
Данный метод позволяет размещать отдельную Цей метод дозволить розмістити окрему кнопку для оплаты через оплати Privat24 без использования платежной формывикористання платіжної форми.
| Note |
|---|
Добавление атрибута Заборонено додавати атрибут target="_blank" на кнопку оплаты, оплати для открытия відкриття Privat24 в новом окне, строго запрешеноновому вікні. |
| Note |
|---|
Оплата Privat24 не поддерживает холдирование средств підтримує холдування коштів (HOLD). |
| Iframe |
|---|
| scrolling | no |
|---|
| src | https://devplaton.com.ua/invoices/demo_buttons/payment_privat24.php |
|---|
| width | 570 |
|---|
| frameborder | hide |
|---|
| height | 55 |
|---|
|
Чеклист интеграции
Чекліст інтеграції
- Привести сайт / приложение к соответствию требованиям.
- Интегрировать формирование и отправку запроса согласно APIІнтегрувати цей API метод.
- Передать Передати тех поддержке підтримці PSP Platon ссылку посилання для Callback.
- Провести оплату используя реальную карту (активируется после подписание договорареальною карткою (активується після підписання договору).
- Получить Callback.
| Expand |
|---|
|
У вашего сайта должен быть SSL сертификат. Для проверки валидности и срока действия вашего SSL сертификата рекомендуем воспользоваться сервисом по ссылке. |
| Expand |
|---|
| title | Логотипы платежных систем и PSP Platon |
|---|
|
В футере вашего сайта необходимо разместить логотипы платежных систем и PSP Platon.
Скачайте подходящие под стиль вашего сайта варианты логотипов.
| Include Page |
|---|
Логотипи для розміщення | Логотипи для розміщення | | Expand |
|---|
|
Необходима поддержка протокола TLS не ниже версии 1.2 |
- Отримати Callback та змінити статус оплати на вашому сайті.
| Include Page |
|---|
| Вимоги до сайтів та додатків |
|---|
| Вимоги до сайтів та додатків |
|---|
|
HTTP METHOD: POST
API ENDPOINT: https://secure.platononline.com/payment/auth
ЗначениеОписаниеОсобенностиОбязательно | String | API ключ мерчанта | Ключ |
предоставляется почту мерчантуОбязательно платежного ОбязательноОбязательноСумма платежаВерный вариант Неверные варианты Невалідні варіанти 1000
1000.0
1,000.0
1,000.00 |
|
currency
|
Обязательно платежа возможна только в национальной валюте гривнеможлива лише в національній валюті гривні. |
|
description
|
ОбязательноОписание платежа кириллических символов необходимо использовать кириличних символів необхідно використовувати формат UTF-8 |
Max 5000 |
символовОбязательноСсылка по которой будет отправлен клиент после успешной оплатыПосилання по якому буде відправлений платник після успішної оплати | Max 255 |
символовОБЯЗАТЕЛЬНОПочта плательщикаОбязательно валидная почтаОбов'язково валідна пошта. |
|
Отсутствие пробелов символа.ОБЯЗАТЕЛЬНО телефона плательщикаОбязательный телефона символа.ОбязательноКонтрольная подписьКонтрольний підпис | | Code Block |
|---|
| md5(
strtoupper(
strrev($key).
strrev($payment).
strrev($data).
strrev($url).
strrev($pass)
)
) |
|
lang
|
НЕ ОбязательноRUЯзык отображения формы | В приоритете настройка языка браузера плательщикаМова відображення платіжної форми | В приоритеті cookie в браузері клиента з параметром lang Стандарт ISO 639-1 |
first_name
|
НЕ ОбязательноИмя плательщика символаНЕ ОбязательноФамилия плательщика символаНЕ ОбязательноАдрес плательщика символаНЕ ОбязательноПочтовый код плательщикаПоштовий індекс платника | Max 32 |
символаНЕ ОбязательноГород плательщика символаНЕ ОбязательноДвухзначный код страны плательщикаНЕ Обязательно штата, провинции или области плательщикаштату, провінції або області платника | |
Обязательный Обов'язковий параметр для |
|
стран НЕ Обязательно кошелька пользователя обязательно для типов бизнеса связанных с виртуальными обов'язкове для типів бізнесу пов'язаниз з віртуальними активами |
order
|
НЕ Обязательно платежа системе символаНЕ Обязательно дополнительной настройкидодаткового налаштування |
|
ext1, ext2, ext3, ext4, ext5, ext6, ext7, ext8, ext9, ext10
|
обязательноДополнительные поля10 додаткових полів | Max 1024 |
символа каждом поле
Примеры запроса
Приклад запиту
| Expand |
|---|
| title | Пример запроса Приклад запиту на PHP + HTML |
|---|
|
| Warning |
|---|
Использование cURL для этого запроса запрещеноЗапит має відправлятися з браузера платника Client - Server, а не з сервера мерчанта Server - Server. |
| Info |
|---|
Content-Type: form-data или або x-www-form-urlencoded |
| Code Block |
|---|
| <?php
$pass = '***';
$data['key'] = '***';
$data['url'] = 'http://google.com';
$data['data'] = base64_encode(
json_encode(
array(
'amount' => '100.00',
'description' => 'Product',
'currency' => 'UAH'
)
)
);
$data['payment'] = 'P24';
$sign = md5(
strtoupper(
strrev($data['key']).
strrev($data['payment']).
strrev($data['data']).
strrev($data['url']).
strrev($pass)
)
);
?>
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Payment</title>
</head>
<body onload="javascript:document.forms[0].submit()">
<form action="https://secure.platononline.com/payment/auth" method="post">
<input type="hidden" name="payment" value="<?=$data['payment']?>" />
<input type="hidden" name="key" value="<?=$data['key']?>" />
<input type="hidden" name="url" value="<?=$data['url']?>" />
<input type="hidden" name="data" value="<?=$data['data']?>" />
<input type="hidden" name="sign" value="<?=$sign?>" />
</form>
</body>
</html> |
|
В целях тестирования необходимо использовать реальную карту привязанную к Приват24.
Проверка платежей
Тестування
В цілях тестування необхідно використовувати реальну картку прив'язану до Privat24.
| Expand |
|---|
| title | Полный список методов получения результата транзакцииСписок методів перевірки статусів транзакцій |
|---|
|
| Include Page |
|---|
| Отримання результату транзакції |
|---|
| Отримання результату транзакції |
|---|
|
|
| Expand |
|---|
| title | Особенности работы с Особливості роботи з Callback |
|---|
|
| Include Page |
|---|
| Работа Робота з CallbackРабота |
|---|
| Робота з Callback |
|---|
|
|
| Expand |
|---|
|
| Expand |
|---|
| title | Пример POST параметров в Callback при успешной оплате |
|---|
|
| Code Block |
|---|
|
array (
'id' => '12345-12345-12345',
'order' => '12345678',
'status' => 'SALE',
'description' => 'description 12345',
'amount' => '99.99',
'currency' => 'UAH',
'date' => '2020-02-14 11:11:11',
'ip' => '172.172.17.172',
'sign' => 'qwerty123uiop456asdfgh789jkl012z',
'number' => '411156*89',
'email' => NULL,
'name' => ' ',
'phone' => NULL,
'ext1' => '12345678',
) |
Параметр | Описание |
|---|
id
| Уникальный ордер ID транзакции в Platon |
order
| Ордер ID транзакции в системе мерчанта. Если параметр не передавался система Platon присвоит его самостоятельно |
status
| SALE
|
number
| Маска карты в формате ХХХХХХ*ХХ |
description
| Описание |
amount
| Сумма списания |
currency
| Валюта транзакции |
name
| Сума передаваемых параметров first_name и last_name |
email
| E-mail плательщика |
phone
| Телефон плательщика |
date
| Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS) |
ip
| IP адрес плательщика |
ext1-ext10
| Дополнительные поля от 1 до 10 |
sign
| Зашифрованная подпись для проверки достоверности коллбека | Code Block |
|---|
md5(
strtoupper(
$pass.
$order_id
)
) |
|
| Expand |
|---|
| title | Пример GET параметров |
|---|
|
| Tip |
|---|
Плательщик будет отправлен по ссылке указанной в url с добавлением | Include Page |
|---|
| БезопасностьБезпека | Безопасность |
|---|
|
|
Callback при успешной оплате
Для просмотра примера раскройте список
При успешной оплате:
| Include Page |
|---|
| Callback / Response - P24 |
|---|
| Callback / Response - P24 |
|---|
|
| Expand |
|---|
| title | Приклад GET параметрів |
|---|
|
| Tip |
|---|
Платник буде відправлений за посиланням вказаному в url с додаванням order методом GET |
| Code Block |
|---|
| array (
'token' => '12345678',
) |
|
При
неуспешной оплатеневдалій оплаті:
| Note |
|---|
При неуспешной оплате невдалій оплаті Callback не отправляетсявідправляється. |
Ошибки запросов
Помилки запитів
| Expand |
|---|
| title | Список ошибок, их причин и возможных решений. |
|---|
|
| Include Page |
|---|
| Помилки та рішення при запитах |
|---|
| Помилки та рішення при запитах |
|---|
|
|