Зміст
Table of Contents | ||||||||
---|---|---|---|---|---|---|---|---|
|
Опис
Цей функціонал дозволяє розмістити платіжну форму на вашому боці, з вашим унікальним дизайном та без переходу платника на нашу форму для введення карткових даних.
Верифікація картки використовується для:
Подтвердження особи власника картки
Отриманя CARD_TOKEN для наступних виплат та оплат.
Note |
---|
Одну картку можна верифікувати декілька разів. Всі CARD_TOKEN отримані при кожній верифікації будуть різні та активні для подальшого використання. |
Чекліст інтеграції
- Привести сайт / додаток відповідно до вимог.
- Передати тех підтримці PSP Platon посилання для Callback.
- Повідомити тех підтримці PSP Platon ваші IP адреси серверів або про те, що буде використовуватись додаток (в цьому випадку обмеження по IP будуть зняті).
- Провести інтеграцію цього API.
- Відобразити клієнту форму вводу карткових даних.
- Відправити запит з вашого сервера / додатку відповідно до цього API.
- Отримати Response або Callback для редиректу платника на 3DS перевірку.
- Відправити клієнту на 3DS перевірку.
- Отримати Response або Callback зі статусом оплати від PSP Platon.
- Повідомити клієнту про успішну / невдалу оплату.
Вимоги
Include Page | ||||
---|---|---|---|---|
|
API параметри
HTTP METHOD: POST
API ENDPOINT: https://secure.platononline.com/post-unq/
Параметр | Значення | Опис | Особливості | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Код платіжного метода | ||||||||||||
| String | API ключ мерчанта | Ключ надається на пошту мерчанту | |||||||||||
|
| Ознака нульової верифікації | ||||||||||||
| String | ID оплати в системі мерчанта | Max 32 символи | |||||||||||
| Number | Сума оплати |
| |||||||||||
|
| Валюта |
| |||||||||||
| String | Опис |
Max 255 символів | |||||||||||
| Number | IP-адреса платника | В форматі "ХХХ.ХХХ.ХХХ.ХХХ"
| |||||||||||
| String | Посилання по якому буде відправлено клієнта після спроби оплати (успішної або невдалої) | Max 255 символів | |||||||||||
| Number | Повний номер картки | В форматі "ХХХХХХХХХХХХХХХХ" | |||||||||||
| Number | Місяць закінчення терміну дії картки | В форматі "ХХ" | |||||||||||
| Number | Рік закінчення терміну дії картки | В форматі "ХХХХ" | |||||||||||
| Number | CVV код | В форматі "ХХХ" | |||||||||||
| String | Пошта платника |
Max 255 символів | |||||||||||
| Number | Номер телефону платника |
| |||||||||||
|
| Створення токену картки | Для отримання | |||||||||||
|
| Створення токену картки | Для отримання | |||||||||||
| String | Контрольний підпис |
| |||||||||||
|
| Стандартне значення | ||||||||||||
|
| Включити асинхронний режим | В асинхронном режиме обязательное использование коллбеков. | |||||||||||
| String | Ім'я платника | Max 32 символи без пробілів | |||||||||||
| String | Прізвище платника | Max 32 символи без пробілів | |||||||||||
| String | Адреса платника | Max 256 символів | |||||||||||
| String | Країна платника | Стандарт ISO 3166-1 alpha-2 | |||||||||||
| String | Штат платника | Стандарт ISO 3166-2 | |||||||||||
| String | Місто платника | Max 32 символи | |||||||||||
| String | Поштовий індекс платника | Max 32 символи | |||||||||||
| String | 10 додаткових полей |
Приклад запиту
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Info |
---|
Тестування
Цей API запит необхідно тестувати лише в бойовому режимі реальною карткою.
Перевірка оплат
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Callback
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Синхронний режим
Цей режим працює як стандартне налаштування. Передавати async = N
не потрібно.
Асинхронний режим
Цей режим є опцією та активується при передачі додаткового параметру async = Y
. В цьому режимі обов'язково необхідно приймати callback на ваш callback url.
Include Page | ||||
---|---|---|---|---|
|
Include Page | ||||
---|---|---|---|---|
|
Помилки запитів
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|