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

Зміст

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

Опис

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

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

Максимальна сума - 300 000 грн.

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	Фінансовий номер телефону платника прив'язаний до Приватбанк
`ext4` обов'язковий	String	`"{"available_parts_count":"n"}"`	JSON з кількістю обраних частин від 2 до 24 (включно), наприклад `"{"available_parts_count":"6"}"`
`channel_id` опція	String
`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 символи
`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);

Тестовий режим вмикається опціонально на боці PSP Platon.

Для тестування після редіректа клієнта на сторінку оформлення оплати частинами Приватбанк необхідно ввести тестові реквізити:

Телефон - 988748970

Пароль - password8970

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

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

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

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

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

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

Оплата частинами ПриватБанк (Server - Server)

Зміст

Опис

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

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