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

Зміст

Опис

Демо

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