| Info |
|---|
Этот функционал будет активирован после вашего запроса в групповом чате. |
| Table of Contents |
|---|
Описание
Данный метод позволяет размещать отдельную кнопку для оплаты через Privat24 без использования платежной формы.
...
| Info |
|---|
Цей функціонал буде активовано після вашого запиту в груповому чаті. |
Зміст
| Table of Contents | ||||||||
|---|---|---|---|---|---|---|---|---|
|
Опис
Цей метод дозволить розмістити окрему кнопку для оплати Privat24 без використання платіжної форми.
| Note |
|---|
Заборонено додавати атрибут |
...
оплати для |
...
відкриття Privat24 в |
...
новому вікні. |
| Note |
|---|
Оплата Privat24 не |
...
підтримує холдування коштів (HOLD). |
Демо
| Iframe | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
Требования к сайту
Добавить логотипы платежных систем Visa и Mastercard
Добавить логотип Privat24
Добавить логотип PSP Platon
API параметры запроса
Чекліст інтеграції
- Привести сайт / приложение к соответствию требованиям.
- Інтегрувати цей API метод.
- Передати тех підтримці PSP Platon посилання для Callback.
- Провести оплату реальною карткою (активується після підписання договору).
- Отримати Callback та змінити статус оплати на вашому сайті.
Вимоги
| Include Page | ||||
|---|---|---|---|---|
|
API параметри
HTTP METHOD: POST
API ENDPOINT: https://secure.platononline.com/payment/auth
Параметр |
|---|
...
Значение
...
Описание
...
Особенности
...
Обязательно
...
Значення | Опис | Особливості | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| String | API ключ мерчанта | Ключ | |||||||
...
надається на пошту мерчанта | ||||||
| ||||||
...
| |||
...
payment
| Код |
...
платіжного метода | |||||
|
...
data
...
|
| Number |
...
Сума оплати |
|
...
|
...
| |||||
|
...
|
| Валюта |
...
|
...
| |||||
|
...
| String |
...
Опис |
|
...
Max 5000 |
...
символів | ||||||
| ||||||
...
url
...
String
...
Ссылка по которой будет отправлен клиент после успешной оплаты
...
| String | Посилання по якому буде відправлений платник після успішної оплати | Max 255 символів | |||||||||||
| String | Пошта платника |
Max 255 символів | |||||||||||
| ||||||||||||||
...
| Number | Номер телефону платника |
Max 255 символів | ||||||
| String | ||||||||
...
Контрольний підпис |
|
...
|
...
|
...
|
...
|
...
| ||||
| ||||
...
| ||||
...
lang
...
email
...
String
...
Почта плательщика
...
Max 255 символа
|
| |||
...
Язык отображения формы
...
В приоритете настройка языка браузера плательщика
...
| Status | ||||
|---|---|---|---|---|
|
Мова відображення платіжної форми | В приоритеті cookie в браузері клиента з параметром lang | |||||
| ||||||
...
first_name
...
String
...
| String | Імʼя платника | Max 32 | |||
...
| Status | ||||
|---|---|---|---|---|
|
символи | |
| |
...
String
...
...
Max 32 символа
| ||||||
...
phone
...
Number
...
Номер телефона плательщика
...
| Note |
|---|
Если ваше юр. лицо открыто в Приватбанк и вы передаете в запросе телефон плательщика, то: 1) обязательный формат телефона 380… 2) номер телефона должен соответствовать финансовому номеру привязанному к карте |
| String | Прізвище платника | Max 32 символи | |||
| ||||||
...
| String | |||
...
Адреса платника | Max 32 |
...
символи | ||||||
| ||||||
...
| String | |||
...
Поштовий індекс платника | Max 32 |
...
символи | ||||||
| ||||||
...
| String | |||
...
Місто платника | Max 32 |
...
символи | ||||||
| ||||||
...
| String | |||
...
Код країни платника | Max 2 символи | |||||
| ||||||
...
| String | Код | |||
...
штату, провінції або області платника |
|
...
|
...
Max 3 символа. | ||||||
| ||||||
...
| String | Номер електронного | |||
...
гаманця платника | Поле |
...
обов'язкове для типів бізнесу пов'язаниз з віртуальними активами | ||||||
| ||||||
...
| String | ID | |||
...
оплати в |
...
системі мерчанта | Max 32 |
...
символи | ||||||
| ||||||
...
formid
...
String
...
| String | Параметр додаткового налаштування | ||||
| ||||||
...
ext1-ext10
...
String
...
| String | 10 додаткових полів | Max 1024 | |||
...
символи в |
...
кожному ext |
...
полі |
...
Приклад запиту
...
| Expand |
|---|
...
|
...
Примеры запроса
Для просмотра примера раскройте список
...
| |||||||||
|
| Warning |
|---|
Использование cURL для этого запроса запрещено |
Тестирование
В целях тестирования необходимо использовать реальную карту привязанную к Приват24.
Проверка платежей
Получить информацию о платежах можно несколькими способами:
Используя Callback для автоматизации процесса зачисления в системе на вашей стороне
Нотификация в Telegram Bot об успешной оплате с деталями платежа сразу после списания
В вашем личном кабинете Platon
CSV файл с деталями платежей скачав в личном кабинете Platon
Письмо об успешном платеже на почту мерчанта и / или плательщика
Банковский реестр на почту или ваш FTP
Работа с Callback
| Info |
|---|
Рекомендуем ознакомиться с разделами: |
Callback при успешной оплате
Для просмотра примера раскройте список
...
| 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
)
) |
...
| title | Пример GET параметров |
|---|
...
Тестування
В цілях тестування необхідно використовувати реальну картку прив'язану до Privat24.
Перевірка платежів
| Expand | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
Callback
| Expand | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
| Expand | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
| Include Page | ||||
|---|---|---|---|---|
|
| Expand | |||||||
|---|---|---|---|---|---|---|---|
| |||||||
|
Callback при неуспешной оплате
| Info |
|---|
При неуспешной оплате коллбек не отправляется |
Ошибки запросов
В ходе проведения запрос вы можете получить разные ошибки. Пожалуйста, ознакомьтесь со списком возможных ошибок, их причин и возможности решения.
...
При невдалій оплаті:
| Note |
|---|
При невдалій оплаті Callback не відправляється. |
Помилки запитів
| Expand | ||
|---|---|---|
|
...
Ошибка
...
Причины
...
Решение
...
Response: {"result":"ERROR","error_message":"Incorrect sign"}
...
Неверно сформирована зашифрованная подпись.
...
Проверьте верность сформированной подписи. Если ошибку не нашли обратитесь в тех поддержку.
...
Добавлены параметры, которые не входят в данный запрос.
...
Проверьте список передаваемых параметров. Если ошибку не нашли обратитесь в тех поддержку.
...
Неверно зашифрована data.
...
Проверить используете ли вы UTF-8 и верный формат параметров.
...
Response: {"result":"ERROR","error_message":"Empty action"}
...
Параметр action заполнен не верно, пуст, или не на первом месте в списке параметров запроса.
...
Проверьте список передаваемых параметров. Если ошибку не нашли обратитесь в тех поддержку.
...
Response: {"result":"ERROR","error_message":"Order already exists"}
...
Значение order_id должно быть уникальным. Данная ошибка говорит о том, что у вас уже была успешная транзакция с таким order_id.
...
Заменить значение order_id на новое уникальное.
...
Response: {"result":"ERROR","error_message":"Service error"}
...
Ситуация требует внимания сотрудников Platon.
...
Рекомендуем обратиться в тех саппорт Platon для проверки причины.
...
Response: {"result":"ERROR","error_message":"Previous transaction not completed"}
...
Ситуация требует внимания сотрудников Platon.
...
| ||||||
|