DEBIT_PREPARE

Описание

Данный метод позволяет получить преимущество при погашении клиентами кредитных организаций используя пониженный тариф по Дебету.

Cо стороны плательщика проводится обычная оплата с вводом всех карточных данных

Обязательные требования к сайту

Разместить логотипы платежных систем Visa и Mastercard

Добавить логотипы PSP Platon

API параметры запроса

HTTP METHOD: POST

API ENDPOINT: https://secure.platononline.com/p2p-debit/

Параметр	Значение	Описание	Особенности	Обязательно
`action`	`DEBIT_PREPARE`	Код платежного метода		Да
`async`	`Y` `N`	Включить асинхронный режим	В асинхронном режиме обязательное использование коллбеков. По умолчанию значение "N"	Нет
`channel_id`	String	Дополнительный платежный канал	Позволяет отправить платежи на другой банковский терминал	Нет
`client_key`	String	API ключ мерчанта	Ключ предоставляется на почту мерчанту	Да
`order_id`	String	ID платежа в системе мерчанта	Max 32 символа	Да
`order_amount`	Number	Сумма платежа	Верный вариант 1000.00 Неверные варианты 1000 1000.0 1,000.0 1,000.00	Да
`order_currency`	`UAH`	Валюта платежа	Оплата возможна только в национальной валюте гривне	Да
`order_description`	String	Описание платежа	Для кириллических символов необходимо использовать формат UTF-8 Max 255 символов	Да
`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	Штат плательщика	Обязательный параметр для стран US, CA, AU Стандарт ISO 3166-2 В формате "ХХ" 2 символа Укажите "NA", если нет данных	Да
`payer_city`	String	Город плательщика	Max 32 символа Укажите "NA", если нет данных	Да
`payer_zip`	String	Почтовый индекс плательщика	Max 32 символа Укажите "NA", если нет данных	Да
`payer_email`	String	Почта плательщика	Max 255 символа	Да
`payer_phone`	Number	Номер телефона плательщика	Если ваше юр. лицо открыто в Приватбанк и вы передаете в запросе телефон плательщика, то: обязательный формат телефона 380… номер телефона должен соответствовать финансовому номеру привязанному к карте	Да
`payer_ip`	Number	IP-адрес плательщика	В формате "ХХХ.ХХХ.ХХХ.ХХХ" IPv6 на данный момент не поддерживается	Да
`card_number`	Number	Полный номер карты	В формате "ХХХХХХХХХХХХХХХХ" 16 символов	Да
`card_exp_month`	Number	Месяц окончания срока действия карты	В формате "ХХ" 2 символа	Да
`card_exp_year`	Number	Год окончания срока действия карты	В формате "ХХХХ" 4 символа	Да
`card_cvv2`	Number	Проверочный код на карте	В формате "ХХХ" 3 символа	Да
`req_token`	`Y` `N`	Для получения card_token	По умолчанию "N"	Да
`hash`	String	Контрольная подпись		Да

Примеры запроса:

Для просмотра примера раскройте список

Пример запроса на PHP

<?php
$pass='Xp7aNCuHSKqK3K488ZxBPV4n6S4tjyFy';
$params['action']='DEBIT_PREPARE';
$params['client_key']='FLN0X1QH0Q';  
$params['order_id']='Platon_test'.rand(446, 1000);
$params['order_amount']='500.30';
$params['order_currency']='UAH';
$params['order_description']='test_by_Platon';
$params['card_number'] = '4999999999990011';
$params['card_exp_month'] = '01';
$params['card_exp_year'] = '2022';
$params['card_cvv2'] = '222';
$params['payer_first_name']='Jack';
$params['payer_last_name']='Dan';
$params['payer_phone']='+380111111111';
$params['payer_address']='NA';
$params['payer_country']='UA';
$params['payer_state']='NA';
$params['payer_city']='NA';
$params['payer_zip']='01001';
$params['payer_email']='test@test.com';
$params['payer_ip']='213.186.115.164'; 
$params['term_url_3ds']='https://secure.platononline.com';
$params['signature'] = sha1($pass . strtolower(implode('', $params)));
$url = 'https://secure.platononline.com/p2p-debit/';


$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://secure.platononline.com/p2p-debit/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => $params,
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
?>

Получение статуса транзакции в Callback и Response:

Ответы будут поступать с наших IP:
78.140.172.231
62.113.223.114
78.140.135.130
167.99.253.235

Для получения коллбеков отправьте ссылку на ваш обработчик в ваш групповой чат. Ссылка для коллбеков прописывается на стороне Platon.

После отправки коллбека в ответ Platon должен получить код HTTP 200 OK. Если коллбек не удалось доставить будет произведено до 5 попыток повторной отправки в течение 60 секунд.

Опциональные варианты активация которых происходит по вашему обращению в групповом чате:

Коллбеки в формате JSON
Basic Authorization

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

Для просмотра примера раскройте список

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

Данный режим активируется при передаче ‘async’='Y'. В этом режиме обязательно необходимо принимать callback на ваш callback url.

Для просмотра примера раскройте список

Дополнительная проверка оплаты:

Для получения информации об оплате в случае, если ваша система не смогла принять Callback, Response или по другой причине, можно воспользоваться дополнительными API запросами проверки: