| Info |
|---|
Этот функционал будет активирован после вашего запроса в групповом чате. |
| Table of Contents |
|---|
Описание:
Данный метод позволяет размещать отдельную кнопку для оплаты через Privat24 без использования платежной формы.
...
| Info |
|---|
Цей функціонал буде активовано після вашого запиту в груповому чаті. |
Зміст
| Table of Contents | ||||||||
|---|---|---|---|---|---|---|---|---|
|
Опис
Цей метод дозволить розмістити окрему кнопку для оплати Privat24 без використання платіжної форми.
| Note |
|---|
Заборонено додавати атрибут |
...
оплати для |
...
відкриття Privat24 в |
...
новому вікні. |
| Note |
|---|
Оплата Privat24 не |
...
підтримує холдування коштів (HOLD). |
Демо
...
| Iframe | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
...
Обязательные требования к сайту:
Добавить логотип Privat24
Добавить логотип PSP Platon
API Endpoint (cсылка для отправки запросов):
Только Form HTML запрос.
...
Чекліст інтеграції
- Привести сайт / приложение к соответствию требованиям.
- Інтегрувати цей API метод.
- Передати тех підтримці PSP Platon посилання для Callback.
- Провести оплату реальною карткою (активується після підписання договору).
- Отримати Callback та змінити статус оплати на вашому сайті.
Вимоги
| Include Page | ||||
|---|---|---|---|---|
|
API параметри
HTTP METHOD: POST
API ENDPOINT: https://secure.platononline.com/payment/auth
...
Описание параметров запроса:
...
Параметр
...
Значение
...
Описание
...
Особенности
...
Обязательно
...
Параметр | Значення | Опис | Особливості | |||||||
|---|---|---|---|---|---|---|---|---|---|---|
| String | API ключ мерчанта | Ключ | |||||||
...
Да
...
надається на пошту мерчанта | |||||||||
|
| Код | |||||||
...
Да
...
data
...
amount
...
Number
...
Сумма платежа
...
платіжного метода | |||||||||||||||||||
|
| Number | Сума оплати |
|
...
|
...
Да
...
|
| Валюта |
...
|
...
Да
...
description
...
String
...
| |||||||||||
| String | Опис |
|
...
Max 5000 |
...
Да
...
символів | ||||||||
| String | |||||||
...
Ссылка по которой будет отправлен клиент после успешной оплаты
...
Max 255 символов
...
Да
...
sign
...
String
...
Посилання по якому буде відправлений платник після успішної оплати | Max 255 символів | ||||||||||||||
| String | Пошта платника |
Max 255 символів | ||||||||||||
| Number | Номер телефону платника |
Max 255 символів | ||||||||||||
| String | Контрольний підпис |
| ||||||||||||
...
|
...
|
...
|
...
|
...
|
...
Да
...
lang
...
UK, RU, EN
...
Язык отображения формы
...
В приоритете настройка языка браузера плательщика
...
Нет
...
...
String
...
Почта плательщика
...
Max 255 символа
...
Нет
...
first_name
...
String
...
Имя плательщика
...
Max 32 символа
...
Нет
...
last_name
...
String
...
Фамилия плательщика
...
Max 32 символа
...
Нет
...
phone
...
Number
...
Номер телефона плательщика
...
| Note |
|---|
Если ваше юр. лицо открыто в Приватбанк и вы передаете в запросе телефон плательщика, то: 1) обязательный формат телефона 380… 2) номер телефона должен соответствовать финансовому номеру привязанному к карте |
...
Нет
...
address
...
String
...
Адресс плательщика
...
Max 32 символа
...
Нет
...
zip
...
String
...
Почтовый код плательщика
...
Max 32 символа
...
Нет
...
city
...
String
...
Город плательщика
...
Max 32 символа
...
Нет
...
country
...
String
...
|
| Мова відображення платіжної форми | В приоритеті cookie в браузері клиента з параметром lang | |||||||
| String | Імʼя платника | Max 32 символи | |||||||
| String | Прізвище платника | Max 32 символи | |||||||
| String | Адреса платника | Max 32 символи | |||||||
| String | Поштовий індекс платника | Max 32 символи | |||||||
| String | Місто платника | Max 32 символи | |||||||
| String | Код країни платника | ||||||||
...
Max 2 символи | |||||||||
| String | Код | |||||||
...
штату, провінції або області платника |
|
...
|
...
|
...
Max 3 символа. | |||||||||
| String | Номер електронного | |||||||
...
гаманця платника | Поле |
...
Нет
...
обов'язкове для типів бізнесу пов'язаниз з віртуальними активами | |||||||||
| String | ID | |||||||
...
оплати в |
...
системі мерчанта | Max 32 |
...
Нет
...
символи | |||||||||
| String | Параметр | |||||||
...
додаткового налаштування |
...
Нет
...
ext1-ext10
...
String
...
Дополнительные поля
...
Max 1024 символа в каждом ext поле
...
Нет
Примеры запроса:
...
| String | 10 додаткових полів | Max 1024 символи в кожному ext полі | |||||||
Приклад запиту
| Expand | |
|---|---|
|
...
Параметр
...
Описание
...
id
...
Уникальный ордер ID транзакции в Platon
...
order
...
Ордер ID транзакции в системе мерчанта. Если параметр не передавался система Platon присвоит его самостоятельно
...
status
...
SALE
...
number
...
Маска карты в формате ХХХХХХ*ХХ
...
description
...
Описание
...
amount
...
Сумма списания
...
currency
...
Валюта транзакции
...
name
...
Сума передаваемых параметров first_name и last_name
...
...
E-mail плательщика
...
phone
...
Телефон плательщика
...
date
...
Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)
...
ip
...
IP адрес плательщика
...
ext1-ext10
...
Дополнительные поля от 1 до 10
...
sign
...
Зашифрованная подпись для проверки достоверности коллбека
...
| title | Пример GET параметров |
|---|
...
| |||||||||
|
| Warning |
|---|
Использование cURL для этого запроса запрещено |
Дебагинг недоставленных Callback:
С целью дебагинга работы вашего сервера на ошибки получения Callback можем предоставить вам телеграм бот, куда будут поступать тело недоставленных вам Callback и информация об HTTP статусе.
Для настройки телеграм бота обратитесь в ваш груповой чат с просьбой подключить его вам.
...
Тестирование:
В целях тестирования необходимо использовать реальную карту привязанную к Приват24.
Проверка платежей:
Получить информацию о платежах можно такими способами:
Используя Callback для автоматизации процесса зачисления в системе на вашей стороне.
Нотификация в телеграм бот про успешную оплату с данными платежа.
В вашем личном кабинете Platon.
CSV файл с деталями платежей скачав в личном кабинете Platon.
Письмо об успешном платеже на вашу почту.
Банковский реестр на почту или ваш FTP.
Коллбек при успешной оплате:
| Tip |
|---|
Коллбеки будут поступать с наших IP: |
| Info |
|---|
Для получения коллбеков отправьте ссылку на ваш обработчик в ваш групповой чат. Ссылка для коллбеков прописывается на стороне Platon. |
После отправки коллбека в ответ Platon должен получить код HTTP 200 OK. Если коллбек не удалось доставить будет произведено до 5 попыток повторной отправки в течение 60 секунд.
Опциональные варианты активация которых происходит по вашему обращению в групповом чате:
Коллбеки в формате JSON
Basic Authorization
Отправка 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',
) |
| Info |
|---|
Для проверки достоверности полученного callback, рекомендуем сверять подпись sign по формуле md5(strtoupper(pass.order_id)) |
Тестування
В цілях тестування необхідно використовувати реальну картку прив'язану до Privat24.
Перевірка платежів
| Expand | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
Callback
| Expand | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
| Expand | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
| Include Page | ||||
|---|---|---|---|---|
|
| Expand | |||||||
|---|---|---|---|---|---|---|---|
| |||||||
|
...
При невдалій оплаті:
...
| 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.
...
| ||||||
|