IA оплата Privat24™ (Client - Server)

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

Зміст

1 Зміст
2 Опис
3 Демо
4 Чекліст інтеграції
5 Вимоги
6 API параметри
7 Приклад запиту
8 Тестування
9 Перевірка платежів
10 Callback
11 Помилки запитів

Опис

Цей метод дозволить розмістити окрему кнопку для оплати Privat24 без використання платіжної форми.

Заборонено додавати атрибут target="_blank" на кнопку оплати для відкриття Privat24 в новому вікні.

Оплата Privat24 не підтримує холдування коштів (HOLD).

Демо

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

Привести сайт / приложение к соответствию требованиям.

Інтегрувати цей API метод.

Передати тех підтримці PSP Platon посилання для Callback.

Провести оплату реальною карткою (активується після підписання договору).

Отримати Callback та змінити статус оплати на вашому сайті.

Вимоги

API параметри

HTTP METHOD: POST

API ENDPOINT: https://secure.platononline.com/payment/auth

Параметр		Значення	Опис	Особливості

Параметр		Значення	Опис	Особливості
`key` Обов'язковий		String	API ключ мерчанта	Ключ надається на пошту мерчанта
`payment` Обов'язковий		`P24`	Код платіжного метода
`data` Обов'язковий	`amount` Обов'язковий	Number	Сума оплати	Вірний варіант 1000.00 Невалідні варіанти 1000 1000.0 1,000.0 1,000.00
	`currency` Обов'язковий	`UAH`	Валюта	Оплата можлива лише в національній валюті гривні.
	`description` Обов'язковий	String	Опис	Для кириличних символів необхідно використовувати формат UTF-8 Max 5000 символів
`url` Обов'язковий		String	Посилання по якому буде відправлений платник після успішної оплати	Max 255 символів
`email` Обов'язковий		String	Пошта платника	Обов'язково валідна пошта. Відсутність пробілів. Max 255 символів
`phone` Обов'язковий		Number	Номер телефону платника	Обов'язковий формат телефону 380… Max 255 символів
`sign` Обов'язковий		String	Контрольний підпис	`md5( strtoupper( strrev($key). strrev($payment). strrev($data). strrev($url). strrev($pass) ) )`
`lang` не Обов'язковий		`UK` `EN`	Мова відображення платіжної форми	В приоритеті cookie в браузері клиента з параметром lang Стандарт ISO 639-1
`first_name` не Обов'язковий		String	Імʼя платника	Max 32 символи
`last_name` не Обов'язковий		String	Прізвище платника	Max 32 символи
`address` не Обов'язковий		String	Адреса платника	Max 32 символи
`zip` не Обов'язковий		String	Поштовий індекс платника	Max 32 символи
`city` не Обов'язковий		String	Місто платника	Max 32 символи
`country` не Обов'язковий		String	Код країни платника	Стандарт ISO 3166-1 alpha-2 Max 2 символи
`state` не Обов'язковий		String	Код штату, провінції або області платника	Обов'язковий параметр для країн US, CA, AU Стандарт ISO 3166-2 Max 3 символа.
`customer_wallet` не Обов'язковий		String	Номер електронного гаманця платника	Поле обов'язкове для типів бізнесу пов'язаниз з віртуальними активами
`order` не Обов'язковий		String	ID оплати в системі мерчанта	Max 32 символи
`formid` не Обов'язковий		String	Параметр додаткового налаштування
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` не Обов'язковий		String	10 додаткових полів	Max 1024 символи в кожному ext полі

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

Запит має відправлятися з браузера платника Client - Server, а не з сервера мерчанта Server - Server.

Content-Type: form-data або x-www-form-urlencoded

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

Postman Collection

Тестування

В цілях тестування необхідно використовувати реальну картку прив'язану до Privat24.

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

Callback

Платник буде відправлений за посиланням вказаному в url с додаванням order методом GET

array (
  'token' => '12345678',
)

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

При невдалій оплаті Callback не відправляється.

Документація