Дебет C2A оплата по 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`	Код платіжного методу
`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($card_token). 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';
  $data['amount'] = '1000.00';
  $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($card_token).
              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 не відправляється.

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