Цей функціонал буде активовано після вашого запиту в груповому чаті.
Зміст
Опис
Регулярний платіж дозволяє робити списання коштів без участі платника.
В запиті використовується раніше збережена картка у вигляді зашифрованого CARD_TOKEN, який можна отримати при першій транзакції по картці.
Вимоги
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 | Токен картки |
|
| String | Пошта платника | Валідна пошта Без пробілів |
| Number | IP-адрес платника | В форматі "ХХХ.ХХХ.ХХХ.ХХХ" IPv6 не підтримується |
| String | Посилання куди перейде платник після проби оплати (успішної чи невдалої) | |
|
| Ознака регулярної оплати | |
| String | Контрольний підпис | md5( strtoupper( strrev($payer_email). $client_pass. strrev($card_token) ) ) Если при первоначальном запросе на оплату не был указан |
|
| Включити асинхронний режим | В асинхронному режимі обов'язкове використання коллбеків. |
| String | Додатковий платіжний канал | Дозволяє відправити оплати на інший банківський термінал |
| String | Ім'я платника | Max 32 символи без пробілів |
| String | Прізвище платника | Max 32 символи без пробілів |
| String | Адреса платника | Max 256 символів |
| String | Країна платника | В форматі "ХХ" |
| String | Штат платника | В форматі "ХХ" |
| String | Місто платника | Max 32 символи |
| String | Поштовий індекс платника | Max 32 символи |
| Number | Номер телефону платника | В форматі “380XXXXXXXXX” |
| String | Номер електронного гаманця платника | Поле обов'язкове для типів бізнесу пов'язаних з віртуальними активами |
|
| HOLD коштів | Стандартне значення |
Приклад запиту
Тестування
В цілях тестування використовуйте card_token
отриманий з коллбека успішної транзакції по одному з вказаних методів:
IE оплата карткою
Верифікація картки
C2A оплата
Виплата на картку по повному номеру картки
Перевірка платежів
Callback
Синхронний режим:
Стандартний режим. Передавати async = N
не потрібно.
При успешній оплаті (синхронний режим):
При невдалій оплаті (синхронний режим):
Асинхронний режим:
Цей режим активується при передачі async = Y
. В цьому режимі обов'язково необхідно використовувати callback.
Проміжна відповідь (асинхронний режим):
При успешній оплаті (асинхронний режим):
При невдалій оплаті (асинхронний режим):
Протерміновані токени
Якщо у відповіді на запит ви отримали одну з вказаних нижче помилок, вам необхідно видалити цей протермінований токен:
{"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
провівши нову оплату чи верифікацію.