Дебет 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

HTTP METHOD: POST

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

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

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

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

Дебет C2A оплата по CARD_TOKEN (Client - Server)

Analytics

Зміст

Опис

Демо

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

Related content