Цей функціонал буде активовано після вашого запиту в груповому чаті.
Зміст
Опис
Регулярный платеж позволяет проводить списание без участия плательщика.
В запросе используется ранее сохраненная карта в виде зашифрованого CARD_TOKEN, который можно получить из callback при первой Оплата картой или Верификации карты.
Дополнительно рекомендуем ознакомиться с разделом /wiki/spaces/docs/pages/1323303006
Требования
Уведомить клиентов об условиях подписки и регулярных списаниях
Получить согласие клиентов на регулярные списания
Получить согласие клиентов с условиями договора публичной оферты
Рекомендуем дать возможность отмены подписки клиентом на сайте или приложении
Согласно правил МПС разрешается 1 попытка списания в день
Разместить договор публичной оферты
Разместить логотипы платежных систем Visa и Mastercard
Добавить логотипы 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 | Токен картки |
|
| 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 | Номер електронного гаманця платника | Поле обов'язкове для типів бізнесу пов'язаних з віртуальними активами |
|
| Стандартне значення |
Приклад запиту
Тестування
В цілях тестування використовуйте card_token
отриманий з коллбека успішної транзакції по одному з вказаних методів:
IE оплата карткою
Верифікація картки
C2A оплата
Виплата на картку по повному номеру картки
Перевірка платежів
Callback
Синхронний режим:
Стандартний режим. Передавати async = N
не потрібно.
При успешній оплаті (синхронний режим):
При невдалій оплаті (синхронний режим):
Асинхронний режим:
Цей режим активується при передачі async = Y
. В цьому режимі обов'язково необхідно використовувати callback.
Проміжна відповідь (асинхронний режим):
При успешній оплаті (асинхронний режим):
При невдалій оплаті (асинхронний режим):
Протерміновані токени
Якщо у відповіді на запит ви отримали одну з вказаних нижче помилок, вам необхідно видалити цей протермінований токен:
Invalid card_exp_month, card_exp_year
Invalid card_exp_month
Initial transaction too old
Ці CARD_TOKEN заблоковані та не підлягають відновленню по причині блокування / закінчення терміну дії картки.
Необхідно отримати новий CARD_TOKEN провівши нову оплату чи верифікацію.