Описание:
Данный метод позволяет получить преимущество при погашении клиентами кредитных организаций используя пониженный тариф по Дебету.
Cо стороны плательщика проводится обычная оплата с вводом всех карточных данных
Обязательные требования к сайту:
Разместить логотипы платежных систем Visa и Mastercard
Добавить логотипы PSP Platon
API Endpoint (cсылка для отправки запросов):
https://secure.platononline.com/p2p-debit/
Описание параметров запроса:
Параметр | Значение | Описание | Особенности | Обязательно |
|---|---|---|---|---|
action | DEBIT_PREPARE | Код платежного метода |
| Да |
async | "Y" или "N" | Включить асинхронный режим | В асинхронном режиме обязательное использование коллбеков. | Нет |
channel_id | String | Дополнительный платежный канал | Позволяет отправить платежи на другой банковский терминал | Нет |
client_key | String | API ключ мерчанта | Ключ предоставляется на почту мерчанту | Да |
order_id | String | ID платежа в системе мерчанта | Max 32 символа | Да |
order_amount | Number | Сумма платежа | Верный вариант 1000.00 Неверные варианты 1000 | Да |
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 символа | Да |
payer_country | String | Страна плательщика | Стандарт ISO 3166-1 alpha-2 | Да |
payer_state | String | Штат плательщика | Обязательный параметр для стран US, CA, AU Стандарт ISO 3166-2 | Да |
payer_city | String | Город плательщика | Max 32 символа | Да |
payer_zip | String | Почтовый индекс плательщика | Max 32 символа | Да |
payer_email | String | Почта плательщика | Max 255 символа | Да |
payer_phone | Number | Номер телефона плательщика | Если ваше юр. лицо открыто в Приватбанк и вы передаете в запросе телефон плательщика, то:
| Да |
payer_ip | Number | IP-адрес плательщика | В формате "ХХХ.ХХХ.ХХХ.ХХХ" IPv6 на данный момент не поддерживается | Да |
card_number | Number | Полный номер карты | В формате "ХХХХХХХХХХХХХХХХ" | Да |
card_exp_month | Number | Месяц окончания срока действия карты | В формате "ХХ" | Да |
card_exp_year | Number | Год окончания срока действия карты | В формате "ХХХХ" | Да |
card_cvv2 | Number | Проверочный код на карте | В формате "ХХХ" | Да |
req_token | "Y" или "N" | Для получения card_token | По умолчанию "N" | Да |
hash | String | Контрольная подпись | Да |
Примеры запроса:
Для просмотра примера раскройте список
<?php
$pass='Xp7aNCuHSKqK3K488ZxBPV4n6S4tjyFy';
$params['action']='DEBIT_PREPARE';
$params['client_key']='FLN0X1QH0Q'; //Client's KEY
$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 запросами проверки: