Цей функціонал буде активовано після вашого запиту в груповому чаті.
Зміст
Опис
Цей функціонал дозволить розмістити на вашому боці інтерфейс оплати частинами для клієнтів ПриватБанк.
Використовуючи цей розділ ви зможете реалізувати онлай та оффлайн оплату частинами.
Для використання в оффлайні вам необхідно інтегрувати це API до вашого ПЗ. Механізм взаємодії в такому випадку буде наступним:
Клієнт в оффлайн магазині говорить, що хоче оплатити частинами Monobank.
Менеджер просить назвати номер телефону прив'язаного до Monobank та вводить його разом з кількістю частин в вашому ПЗ, та відправляє запит відповідно до цього API методу.
Клієнту на телефон в додаток Monobank надходить повідомлення з пропозицією про можливість взяття оплати частинами, яке він може прийняти / відхилити, збільшити кількість частин (від наданої мерчантом кількості частин) з додатковою платою з боку клієнта за тарифами Monobank.
Після успішного підтвердження клієнтом в додатку до вас в систему буде відправлено коллбек з даними про платіж по результату якого менеджер може вибити чек та видати товар.
Минимальная сумма - отсутствует.
Максимальная сумма - 300 000 грн.
Этот функционал работает в два этапа. При успешном запросе общая сумма попадает в холд, после чего необходимо будет провести подтверждение списания для зачисления средств на ваш счет.
Подтверждение списания возможно несколькими способами:
Вручную в нашем личном кабинете
Настроить на стороне PSP Platon автоматическое списание в срок от 1 часа до 29 дней, о чем просьба сообщить в чат
Настроить автоматическое списание по API запросу списания с холда под вашу бизнес-логику
Внимание! Подтверждение списания и возврат производится в полном объеме суммы кредита. Частичное списание или частичный возврат запрещены.
Чеклист интеграции
- Привести сайт / приложение к соответствию требованиям.
- Передать тех поддержке PSP Platon ссылку для Callback.
- Сообщить в тех поддержке PSP Platon ваши IP адреса сервера сайта или о том, что будет использоваться приложение (в этом случае ограничения по IP будут сняты).
- Провести интеграцию данного API.
- Отобразить клиенту форму для ввода номера телефона, который привязан к Приватбанк.
- Отобразить клиенту выбор количества платежей на ваш выбор в в промежутках от 2 до 24 платежей (включительно).
- Отправить запрос с вашего сервера / приложения согласно данного API.
- Получить Response или Callback со статусом платежа от PSP Platon.
- Уведомить клиента об успешном / не успешном запросе на оплату частями.
Рекомендации
Рекомендуем клиенту самостоятельно вводить свой номер телефона в ПриватБанк. Если у вас в системе уже есть номер телефона клиента, мы не рекомендуем подставлять его в данный запрос, так как возможны ситуации, когда у клиента есть несколько номеров телефонов и тот, что был записан у вас ранее может не совпадать с финансовым номером клиента в приложении Privat24.
Рекомендуем отобразить уведомление, о том что клиенту поступит push-уведомление в приложение Privat24 для ознакомления с договором оплаты частями и решения о согласии с условиями.
Рекомендуем отобразить уведомление, что клиенту необходима карта ПриватБанк.
Рекомендуем отобразить уведомление, что клиенту необходимо проверить доступный размер лимита оплаты частями на соответствие сумме заказа.
Рекомендуем отобразить уведомление, что первый платеж будет списан с клиента сразу.
Требования к сайту
API параметры
HTTP METHOD: POST
API ENDPOINT: https://secure.platononline.com/post/
Параметр | Значение | Описание | Особенности |
---|---|---|---|
|
| Код платежного метода | |
| String | API ключ мерчанта | Ключ предоставляется на почту мерчанту |
| String | ID платежа в системе мерчанта | Max 32 символа |
| Number | Сумма платежа | Верный вариант 1000.00 Неверные варианты 1000 |
|
| Валюта платежа | Оплата возможна только в национальной валюте гривне |
| String | Описание платежа | Для кириллических символов необходимо использовать формат UTF-8 Max 255 символов |
| Number | IP-адрес плательщика | В формате "ХХХ.ХХХ.ХХХ.ХХХ" IPv6 на данный момент не поддерживается |
| String | Ссылка по которой будет отправлен клиент после успешной оплаты при прохождении 3DS | Max 255 символов |
| String | Почта плательщика | Обязательно валидная почта. Отсутствие пробелов. Max 255 символа |
| Number | Финансовый номер телефона плательщика привязанный к Приватбанк | Обязательный формат телефона +380XXXXXXXXX |
| String |
| JSON с количеством выбранных клиентом платежей от 2 до 24 (включительно), например |
| privat_parts | Признак оплаты частями монобанк | |
| String | Контрольная подпись | md5( strtoupper($pass). strrev($order_id) ) |
|
| Включить асинхронный режим | В асинхронном режиме обязательное использование коллбеков. |
| String | Имя плательщика | Max 32 символа без пробелов |
| String | Фамилия плательщика | Max 32 символа без пробелов |
| String | Адрес плательщика | Max 256 символа |
| String | Страна плательщика | Стандарт ISO 3166-1 alpha-2 |
| String | Штат плательщика | Обязательный параметр для стран US, CA, AU Стандарт ISO 3166-2 |
| String | Город плательщика | Max 32 символа |
| String | Почтовый индекс плательщика | Max 32 символа |
| String | 10 дополнительных полей | Max 1024 символа в каждом ext поле |
Примеры запроса
Проверка платежей
Callback
Синхронный режим:
Данный режим работает по умолчанию. Передавать async = N
не нужно.
При успешном редиректе (синхронный режим):
При успешной оплате (синхронный режим):
При неуспешной оплате (синхронный режим):
Асинхронный режим:
Данный режим активируется при передаче async = Y
. В этом режиме обязательно необходимо принимать callback на ваш callback url.