Цей функціонал буде активовано після вашого запиту в груповому чаті.
Зміст
Опис
Оплата в один клик позволяет провести платеж без ввода карточных данных. Для оплаты вам необходимо создать кнопку и разместить на вашем сайте / приложении.
Платіжна форма в цьому виді запиту відсутня.
Кліенту не потрібно вводити CVV.
Якщо необхідна оплата без 3DS перевірки - погодьте це з вашим менеджером PSP Platon.
В запиті використовується раніше збережена картка у вигляді зашифрованого card_token
, який можна отримати з callback при першій оплаті карткою або при верифікації.
Особливості токенів
По одній і тій же картці токен можна отримати декілька разів. При цьому самі ці токени будуть різні і готові до використання.
Токен можна використовувати на всіх API ключах та юр. особах.
Якщо при спробі оплати ви отримали відповідь 102: Token is not active
це значить, що токен не активний і провести транзакцію по ньому не можливо. Такий токен потрібно видалити з вашої бази даних та надати клієнту можливість оплати іншою карткою.
Термін дії CARD_TOKEN відповідає терміну дії картки.
Чекліст інтеграції
- Привести сайт / додаток до відповідності вимогам.
- Проведіть попередню оплату карткою або верифікацію для отримання
card_token
. - Інтегруйте запит відповідно до цього API методу.
- Передати тех підтримці PSP Platon посилання для Callback (якщо раніше не було вказано).
- Передати тех підтримці PSP Platon ваші IP адреси серверів сайту або про те, що буде використовуватись додаток (в цьому випадку обмеження по IP будуть зняті).
- Відобразити клієнту на сайті / додатку кнопку для оплати з маскою картки для розуміння клієнта яка картка буде використана.
- Відправити API запит використовуючи
card_token
. - Отримати Response або Callback для редіректа платника на 3DS перевірку.
- Відправити клієнта на 3DS перевірку.
- Отримати Response або Callback зі статусом оплати від PSP Platon.
- Повідомити клієнта про успішну / невдалу оплату.
Вимоги
API параметри
HTTP METHOD: POST
API ENDPOINT: https://secure.platononline.com/post-unq/
Параметр | Значення | Опис | Особливості |
---|---|---|---|
|
| Код платежного метода | |
| String | API ключ мерчанта | Ключ надається на пошту мерчанта |
| String | ID оплати в системі мерчанта | Max 32 символи |
| Number | Сума оплати | Вірний варіант 1000.00 Невалідні варіанти 1000 |
|
| Валюта | Оплата можлива лише в національній валюті гривні. |
| String | Опис | Max 255 символів |
| String | Токен картки |
|
| Number | IP-адреса платника | В форматі "ХХХ.ХХХ.ХХХ.ХХХ" |
| String | Пошта платника | Обов'язково валідна пошта. Відсутність пробілів. Max 256 символів |
| String | Посилання по якому буде відправлено платника після спроби оплати | Max 255 символів |
| String | Контрольний підпис | md5( strtoupper( strrev($payer_email). $client_pass. strrev($card_token) ) ) Якщо |
| String | Ім'я платника | Мах 32 символи |
| String | Прізвище платника | Мах 32 символи |
| String | Адреса платника | Мах 255 символів |
| String | Країна платника | Стандарт ISO 3166-1 alpha-2 |
| String | Штат платника | Стандарт ISO 3166-2 |
| String | Місто платника | Max 32 символи |
| String | Поштовий індекс платника | Max 32 символи |
| Number | Номер телефону платника | В форматі “380XXXXXXXXX” |
| String | Номер електронного гаманця платника | Поле обов'язкове для типів бізнесу пов'язаних з віртуальними активами |
|
| Включити асинхронний режим | В асинхронному режимі обов'язкове використання коллбеків. Стандартне значення |
| String | Додатковий платіжний канал | Дозволяє перенаправляти платежі на інший банківський термінал |
|
| Стандартне значення | |
| String | 10 додаткових полів | Max 1024 символи в кажному ext полі |
Приклад запиту
Тестування
В цілях тестування використовуйте card_token
отриманий з коллбека успішної транзакції по одному з вказаних методів:
IE оплата карткою
Верифікація картки
C2A оплата
Виплата на картку по повному номеру картки
Перевірка платежів
Callback
Синхронний режим
Стандартний режим. Передавати async = N
не потрібно.
Асинхронний режим
Цей режим вмикається при передачі в запиті параметру async = Y
.
При оплаті з 3DS СИНХРОННИЙ РЕЖИМ
Проміжний редірект платника на 3DS СИНХРОННИЙ РЕЖИМ
При успішній оплаті з 3DS СИНХРОННИЙ РЕЖИМ
Response про фінальний статус при оплаті з 3DS відсутній.
При невдалій оплаті з 3DS СИНХРОННИЙ РЕЖИМ
Response про фінальний статус при оплаті з 3DS відсутній.
При оплаті з 3DS АСИНХРОННИЙ РЕЖИМ
Проміжна відповідь АСИНХРОННИЙ РЕЖИМ
Проміжний редірект платника на 3DS АСИНХРОННИЙ РЕЖИМ
При успішній оплаті з 3DS АСИНХРОННИЙ РЕЖИМ
При невдалій оплаті з 3DS АСИНХРОННИЙ РЕЖИМ
При помилці в запиті
При оплаті без 3DS СИНХРОННИЙ РЕЖИМ
При успішній оплаті без 3DS СИНХРОННИЙ РЕЖИМ
При невдалій оплаті без 3DS СИНХРОННИЙ РЕЖИМ
При оплаті без 3DS АСИНХРОННИЙ РЕЖИМ
Проміжна відповідь АСИНХРОННИЙ РЕЖИМ
При успішній оплаті з 3DS АСИНХРОННИЙ РЕЖИМ
При невдалій оплаті з 3DS АСИНХРОННИЙ РЕЖИМ
При помилці в запиті
Протерміновані токени
Якщо у відповіді на запит ви отримали одну з вказаних нижче помилок, вам необхідно видалити цей протермінований токен:
{"result":"ERROR","error_message":"Invalid card_exp_month, card_exp_year"}
{"result":"ERROR","error_message":"Invalid card_exp_month"}
{"result":"ERROR","error_message":"Initial transaction too old"}
Ці card_token
заблоковані та не підлягають відновленню по причині блокування / закінчення терміну дії картки.
Необхідно отримати новий card_token
провівши нову оплату чи верифікацію.