Зміст
Опис
Цей розділ дозволяє платнику провести платіж вводячи реквізити своєї банківської картки або використовуючи цифрові гаманці та інші методи оплати використовуючи платіжну форму PSP Platon.
Демо
Чекліст інтеграції
- Привести сайт / додаток до відповідності вимогам.
- Провести інтеграцію відповідно до цього API методу.
- Передати тех підтримці PSP Platon посилання для Callback.
- Провести оплату використовуючи тестові реквізити / реальную карту (активується після підписання договору).
- Отримати Callback та змінити статус оплати у вашій системі.
Вимоги
Обмеження
API параметри
HTTP METHOD: POST
API ENDPOINT: https://secure.platononline.com/payment/auth
Параметр | Значення | Опис | Особливості | |
---|---|---|---|---|
| String | API ключ мерчанта | Ключ надається на пошту мерчанта | |
|
| Код платіжного метода | ||
|
| Number | Сума до оплати | Вірний варіант 1000.00 Невалідний варіант 1000 |
|
| Валюта | Оплата можлива лише в національній валюті гривні | |
| String | Опис | Для кириличних символів необхідно використовувати формт UTF-8 Max 5000 символів (латиниця), 2500 (кирилиця). | |
|
| Створення токена картки | Для отримання Якщо токен не потрібен можете не передавати цей параметр. | |
| String | Посилання по якому буде відправлено платника після успішної оплати | Max 1024 символа (латиниця). При відсутності можливості створити вашу власну сторінку успішної оплати можете використати нашу стандартну. | |
| String | Пошта платника | Обов'язково валідна пошта Відсутність пробілів Max 255 символів. | |
| Number | Номер телефона платника | Обов'язковий формат телефону 380… Max 255 символів. | |
|
| Створення токена картки | Для отримання A2C виплата на картку по CARD_TOKEN C2A оплата в 1 клік по CARD_TOKEN Регулярний платіж по CARD_TOKEN Якщо токен не потрібен можете не передавати цей параметр. | |
| String | Контрольний підпис | md5( strtoupper( strrev($key). strrev($payment). strrev($data). strrev($url). strrev($PASSWORD) ) ) | |
| String | ID оплати в системі мерчанта | Max 255 символів. В рамках однієї години після оплати, починаючи не з першої секунди, а через декілька хвилин, необхідних для запису даних в систему, по | |
| String | Посилання по якому буде відправлено платника після 5 невдалих спроб оплати | Max 1024 символів. При відсутності можливості створити вашу власну сторінку невдалої оплати можете використати нашу стандартну. | |
| String | Ім'я платника | Max 50 символів (латиниця), 25 (кирилиця). | |
| String | Прізвище платника | Max 50 символів (латиниця), 25 (кирилиця). | |
| String | Адреса платника | Max 255 символів (латиниця), 126 (кирилиця). | |
| String | Поштовий індекс платника | Max 255 символів. | |
| String | Місто платника | Max 255 символів (латиниця), 126 (кирилиця). | |
| String | Код країни платника | Max 2 символа. | |
| String | Код штату, провінції або області платника | Обов'язковий параметр для країн US, CA, AU Max 3 символа. | |
| String | Номер електронного гаманця платника | Поле обов'язкове для типів бізнесу пов'язаниз з віртуальними активами | |
|
| Мова відображення платіжної форми | В приоритеті cookie в браузері клиента з параметром lang | |
| String | Параметр додаткового налаштування | Max 255 символів. | |
| String | 10 додаткових полів | Max 1024 символа в кожному ext полі (латиниця), 512 (кирилиця). |
Приклад запиту
Тестування
Час платіжної сесії
Стандартно у платника буде 15 хв для проведення оплати. Це означає, що на 15 хвилину та 1 секунду оплата стане не доступною та приведе до помилки. Відлік починається з моменту відкриття платіжної форми.
Перевірка платежів
Callback
При успішній оплаті IA
При успішній оплаті Privat24
При невдалій оплаті:
При невдалій оплаті Callback не відправляється.