Дебет Адванс C2A-IE оплата по CARD_TOKEN (Client - Server)

Зміст

1 Зміст
2 Опис
3 Демо
4 Чекліст інтеграції
5 Вимоги
6 API параметри
7 Приклад запиту
8 Тестування
9 Час платіжної сесії
10 Callback
11 Помилки запитів

Опис

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

З боку платника здійснюється спрощена оплата з введенням лише CVV.

У запиті використовується раніше збережена картка у вигляді зашифрованого card_token, який можна отримати з callback під час першого Дебетового погашення або Верифікації картки.

Додатково рекомендуємо ознайомитися з розділом "Особливості токенів".

Демо

Чекліст інтеграції

Привести сайт / додаток до відповідності вимогам.

Провести інтеграцію відповідно до цього API методу.

Передати тех підтримці PSP Platon посилання для Callback.

Провести оплату використовуючи CARD_TOKEN отриманий при оплаті / виплаті тестовими реквізитами / реальную карту (активується після підписання договору).

Отримати Callback та змінити статус оплати у вашій системі.

Вимоги

Ваш сайт повинен мати SSL-сертифікат.

Для перевірки валідності та терміну дії вашого SSL-сертифіката рекомендуємо скористатися сервісом за посиланням.

У футері вашого сайту необхідно розмістити логотипи платіжних систем і PSP Platon.

Скачайте варіанти логотипів, які підходять під стиль вашого сайту.

Необхідна підтримка протоколу TLS не нижче версії 1.2и

API параметри

HTTP METHOD: POST

API ENDPOINT: https://secure.platononline.com/payment/auth

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

Параметри	Значення	Опис	Особливості
`key` status:ОБов'язковий	String	API ключ мерчанта	Ключ надається на пошту мерчанту
`payment` status:ОБов'язковий	`C2AT,CCT`	Код платіжного метода
`amount` status:ОБов'язковий	Number	Сума до оплати	Вірний варіант 1000.00 Невалідний варіант 1000 1000.0 1,000.0 1,000.00
`currency` status:ОБов'язковий	`UAH`	Валюта	Оплата можлива лише в національній валюті гривні
`description` status:ОБов'язковий	String	Опис	Max 255 символів
`order` status:не ОБов'язковий	String	ID оплати в системі мерчанта	Max 32 символа
`email` status:не ОБов'язковий	String	Пошта платника	Залишити порожнє значення, якщо немає даних
`phone` status:не ОБов'язковий	Number	Номер телефона платника	Обов'язковий формат телефону 380…
`card_token` status:ОБов'язковий	String	Токен карти	`card_token` з коллбека первинної транзакції
`url` status:ОБов'язковий	String	Посилання по якому буде відправлено платника після успішної оплати	Max 1024 символа
`sign` status:ОБов'язковий	String	Контрольний підпис	`md5( strtoupper( strrev($key). strrev($payment). strrev($amount). strrev($currency). strrev($description). strrev($url). strrev($password) ) )`
`error_url` status:не ОБов'язковий	String	Посилання, за яким буде відправлено платника після 5 невдалих спроб оплати	За відсутності посилання помилку буде відображено на платіжній формі
`first_name` status:ОБов'язковий	String	Ім'я платника	Max 32 символа
`last_name` status:ОБов'язковий	String	Прізвище платника	Max 32 символа
`address` status:не ОБов'язковий	String	Адреса платника	Max 255 символа
`zip` status:не ОБов'язковий	String	Поштовий індекс платника	Max 32 символа
`city` status:не ОБов'язковий	String	Місто платника	Max 32 символа
`country` status:не ОБов'язковий	String	Код країни платника	Стандарт ISO 3166-1 alpha-2
`state` status:не ОБов'язковий	String	Код штату, провінції або області платника	Обязательный параметр для стран US, CA, AU Стандарт ISO 3166-2 Значення `NA` якщо немає штату
`lang` status:не ОБов'язковий	`UK` `RU` `EN`	Мова відображення форми	У пріоритеті налаштування мови браузера платника
`formid` status:не ОБов'язковий	String	Параметр додаткового налаштування	Max 255 символів
`itn` status:не ОБов'язковий	String	ІПН платника	Обов'язково, якщо `amount` більше або рівний 30000 грн.
`ext1`, `ext2`, `ext3`, `ext4` status:не ОБов'язковий	String	Додаткові поля	Max 1024 символи в кожному ext полі

Приклад запиту

<?php 
  $data['key'] = '***';
  $data['password'] = '***';
  $data['payment'] = 'C2AT,CCT';
  $data['amount'] = '400.30';
  $data['currency'] = 'UAH';
  $data['description'] = 'Test DEBIT operation by Platon';
  $data['url'] = 'https://www.google.com.ua';
  $data['order'] = 'ABC123';
  $card_token = '******';
  $sign = md5(
            strtoupper(
              strrev($data['key']).
              strrev($data['payment']).
              strrev($data['amount']).
              strrev($data['currency']).
              strrev($data['description']).
              strrev($data['url']).
              strrev($data['password'])
              ))
?>

<!DOCTYPE html>
<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    <title>debi</title>
  </head>
  <body onload="javascript:document.forms[0].submit()">
    <form action="https://secure.platononline.com/payment/auth" method="post">
      <input type="hidden" name="key" value="<?=$data['key']?>" /> 
      <input type="hidden" name="payment" value="<?=$data['payment']?>" />
      <input type="hidden" name="amount" value="<?=$data['amount']?>" />
      <input type="hidden" name="card_token" value="<?=$card_token?>" />
      <input type="hidden" name="currency" value="<?=$data['currency']?>" />
      <input type="hidden" name="description" value="<?=$data['description']?>" />
      <input type="hidden" name="url" value="<?=$data['url']?>" />
      <input type="hidden" name="order" value="<?=$data['order']?>" />
      <input type="hidden" name="sign" value="<?=$sign?>" />
    </form>
  </body>
</html>

Тестування

В цілях тестування використайте CARD_TOKEN отриманий в callback при оплаті / виплаті.

Час платіжної сесії

Стандартно у платника буде 15 хв для проведення оплати. Це означає, що на 15 хвилину та 1 секунду оплата стане не доступною та приведе до помилки. Відлік починається з моменту відкриття платіжної форми.

Стандартний проміжок часу 15 хв є результатом багатьох тестів та більш чим необхідно достатній для проведення оплати.

Якщо у вас є потреба в іншому проміжку, по вашому запиту можна налаштувати час платіжної сесії з наявних варіантів:

10 хв
30 хв
75 хв

Callback

Платника буде відправлено за посиланням вказаним вами в параметр url з додаванням order методом GET

url = https://www.google.com/

order = 12345

Клієнта відправить після успішної оплати на https://www.google.com/?order=12345

При невдалій оплаті:

При невдалій оплаті Callback не відправляється.

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