Цей функціонал буде активовано після вашого запиту в груповому чаті.

Зміст

- 1.1 Зміст
- 1.2 Опис
- 1.3 Чекліст інтеграції
- 1.4 Рекомендації
- 1.5 Best Practices
- 1.6 Вимоги до сайту
- 1.7 API параметри
- 1.8 Приклад запиту
- 1.9 Тестування
- 1.10 Перевірка платежів
- 1.11 Callback
2 Синхронний режим
3 Асинхронний режим
- 3.1 Помилки запитів

Опис

Цей функціонал дозволить розмістити на вашому боці інтерфейс оплати частинами для клієнтів Monobank.

Мінімальна сума - 500 грн.

Максимальна сума - визначається Monobank та відображається в умовах та правилах Monobank.

Після відправки API запиту у платника буде 15 хв на прийняття рішення.

Цей функціонал працює в два етапи. При успішному запиті загальна сума потрапляє в холд, після чого необхідно буде провести підтвердження списання для зарахування коштів на ваш рахунок.

Підтвердження списання можливе декількома методами:

Вручну в нашому особистому кабінеті.
Налаштувати на боці PSP Platon автоматичне підтвердження списання в термін від 1 години до 29 днів, про що необхідно повідомити в груповий чат. В цьому випадку менеджеру мерчанта необхідно вручну перевіряти кінцевий статус оплати в особистому кабінеті PSP Platon. Фінальний статус успішнох оплати буде SETTLED CAPTURE SUCCESS.
Налашатувати по API запиту підтвердження списання з холду під вашу бізнес-логіку використовуючи Підтвердження списання з HOLD.

Ознайомтесь з PDF файлом з Best Practices як найкраще надати клієнтам інформацію про нову для ним можливість оплати частинами на вашому ресурсі:

HTTP METHOD: POST

API ENDPOINT: https://secure.platononline.com/post/

Параметр	Значення	Опис	Особливості

Параметр	Значення	Опис	Особливості
`action` обов'язковий	`SALE_PART`	Код платіжного метода
`client_key` обов'язковий	String	API ключ мерчанта	Ключ надається на пошту мерчанта
`order_id` обов'язковий	String	ID оплати в системі мерчанта	Max 32 символи
`order_amount` обов'язковий	Number	Сума оплати
`order_currency` обов'язковий	`UAH`	Валюта
`order_description` обов'язковий	String	Опис	Max 255 символів
`payer_ip` обов'язковий	Number	IP-адреса платника	В форматі "ХХХ.ХХХ.ХХХ.ХХХ"
`term_url_3ds` обов'язковий	String	Посилання по якому буде відправлено платника після спроби оплати	Max 255 символів
`payer_email` обов'язковий	String	Пошта платника	Max 255 символів
`payer_phone` обов'язковий	Number	Фінансовий номер телефону платника прив'язаний до Monobank
`ext4` обов'язковий	String	`"{"available_parts_count":"n"}"`	JSON з кількістю обраних частин від 3 до 25 (включно), наприклад `"{"available_parts_count":"6"}"`
`channel_id` не обов'язковий
`hash` обов'язковий	String	Контрольний підпис	`md5( strtoupper($pass). strrev($order_id) )`
`async` не обов'язковий	`Y` `N`	Включити асинхронний режим	В асинхронному режимі обов'язкове використання коллбеків. Стандартне значення `N`
`payer_first_name` не обов'язковий	String	Ім'я платника	Max 32 символи без пробілів
`payer_last_name` не обов'язковий	String	Прізвище платника	Max 32 символи без пробілів
`payer_address` не обов'язковий	String	Адреса платника	Max 256 символи Вказати`NA`, якщо немає даних
`payer_country` не обов'язковий	String	Країна платника	Стандарт ISO 3166-1 alpha-2 В форматі "ХХ" 2 символа Вказати `NA`, якщо немає даних
`payer_state` не обов'язковий	String	Штат платника	Стандарт ISO 3166-2 В форматі "ХХ" 2 символа Вказати `NA`, якщо немає даних
`payer_city` не обов'язковий	String	Місто плателника	Max 32 символи Вказати `NA`, якщо немає даних
`payer_zip` не обов'язковий	String	Поштовий індекс платника	Max 32 символи Вказати `NA`, якщо немає даних
`ext1`, `ext2`, `ext3`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` не обов'язковий	String	10 додаткових полів	Max 1024 символи в кажному ext полі

<?php
  $client_pass = '***';
  $data['action'] = 'SALE_PART';
  $data['client_key'] = '***';
  $data['order_id'] = '546-4588';
  $data['order_amount'] = '1000.00';
  $data['order_currency'] = 'UAH';
  $data['order_description'] = 'test';
  $data['payer_first_name'] = 'Ivan';
  $data['payer_last_name'] = 'Ivanov';
  $data['payer_phone'] = '+380111111111';
  $data['payer_email'] = 'sale@gmail.com';
  $data['payer_ip'] = '213.186.115.164';
  $data['term_url_3ds'] = 'https://google.com';
  $data['ext4'] = '{"available_parts_count":"6"}';
  $data['hash'] = md5(
                    strtoupper($client_pass).
                    strrev($data['order_id'])
                  );

$url = 'https://secure.platononline.com/post/';
$crq = curl_init();
curl_setopt($crq, CURLOPT_URL, $url);
curl_setopt($crq, CURLOPT_HEADER, 0);
curl_setopt($crq, CURLOPT_POST, 1);
curl_setopt($crq, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($crq, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($crq, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($crq, CURLOPT_POSTFIELDS, $data);
$result = curl_exec($crq);
if (curl_errno($crq)) {
  echo 'ERROR: '.curl_error($crq);
}else{
  echo $result;
}
curl_close($crq);

Тестування рекомендовано проводити реальним номером телефону, який підключено до Monobank та має відповідний баласн для оплати частинами.

Якщо ви не маєте змоги робити це реальним номером телефону, то можете використати тестове середовище, але зверніть увагу, що його використання сильно відрізняється від реального використання так як не включає в себе використання додатку Monobank яке є обов'язковим при реальній оплаті. Нижче описано варіанти доступні для тестового середовища:

Успішне підтвердження заявки. Для цієї ситуації потрібно передати фейковий номер телефону, що закінчується на 1. У цьому випадку через 5 секунд буде кинуто callback про успішне затвердження заявки.
Заявка, що очікує підтвердження від клієнта. Для цієї ситуації необхідно передати фейковий номер телефону, що закінчується на 2.
Помилка підтвердження заявки через недостатній ліміт у клієнта. Для цієї ситуації потрібно передати фейковий номер телефону, що закінчується на 3. У цьому випадку через 5 секунд буде кинуто callback про відхилення заявки.
Заявка підтверджена клієнтом та очікує на підтвердження від магазину. Для цієї ситуації необхідно передати фейковий номер телефону, що закінчується на 4.

Синхронний режим

Стандартний режим роботи. Передавати async = N не потрібно.

Асинхронний режим

Цей режим активується при передачі async = Y. В цьому режимі є обов'язковим використання коллбеків.

Принципової різниці у використанні синхронного або асинхронного режимів немає. Вам необхідно вибрати в залежності від найбільш зручного варіанту реалізації саме під ваш проект.

Якщо в запиті буде вказано не фінансовий номер телефону клієнта (тобто той який не підв'язаний в Monobank) - буде помилка "decline_reason":"Phone not found in MONO"

Документація

Оплата частинами Monobank (Server - Server)

Зміст

Опис

Синхронний режим

Асинхронний режим