DEBIT_PREPARE

Описание:

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

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

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

Разместить логотипы платежных систем Visa и Mastercard
Добавить логотипы PSP Platon

API Endpoint (cсылка для отправки запросов):

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 запросами проверки: