Оплата в 1 клік по CARD_TOKEN (Client - Server)

Зміст

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

Опис

Оплата в 1 клік спрощує введення карткових даних. Для оплати платнику необхідно ввести лише CVV код.

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

Особливості токенів

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

Інтегрувати це API.

Передати тех підтримці PSP Platon посилання для Callback (якщо раніше не передавали).

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

Отримати Callback.

Відбразити платнику статус оплати.

HTTP METHOD: POST

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

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

Параметр		Значення	Опис	Особливості
`key` обов'язковий		String	API ключ мерчанта	Ключ надається на пошту мерчанту
`payment` обов'язковий		`CCT`	Код платіжного метода
`data` обов'язковий	`amount` обов'язковий	Number	Сума оплати
	`currency` обов'язковий	`UAH`	Валюта
	`description` обов'язковий	String	Опис	Max 5000 символів
`card_token` обов'язковий		String	Токен картки	`card_token` з callback першої оплати
`url` обов'язковий		String	Посилання по якому буде відправлено клієнта після успішної оплати	Max 255 символів
`email` обов'язковий		String	Пошта платника	Max 255 символів
`sign` обов'язковий		String	Контрольний підпис	`md5( strtoupper( strrev($key). strrev($payment). strrev($data). strrev($url). strrev($card_token). strrev($CLIENT_PASSWORD) ) )`
`lang` не обов'язковий		`UK` `EN`	Мова відображення форми	В пріорітеті налаштування мови браузера платника
`first_name` не обов'язковий		String	Ім'я платника	Max 32 символи
`last_name` не обов'язковий		String	Прізвище платника	Max 32 символи
`phone` не обов'язковий		Number	Номер телефону платника
`address` не обов'язковий		String	Адреса платника	Max 32 символи
`zip` не обов'язковий		String	Поштовий індекс платника	Max 32 символи
`city` не обов'язковий		String	Місто платника	Max 32 символи
`country` не обов'язковий		String	Двозначный код країни платника	Стандарт ISO 3166-1 alpha-2
`state` не обов'язковий		String	Код штату, провінції або області платника	Стандарт ISO 3166-2
`order` не обов'язковий		String	ID оплати в системі мерчанта	Max 32 символи
`customer_wallet` не обов'язковий		String	Номер електронного гаманця платника	Поле обов'язкове для типів бізнесу пов'язаних з віртуальними активами
`error_url` не обов'язковий		String	Посилання по якому буде відправлено клієнта після 5 невдалих спроб оплати
`formid` не обов'язковий		String	Параметр додаткового налаштування
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` не обов'язковий		String	Додаткові поля	Max 1024 символів в кожному ext полі

<?php
  $pass = '***';
  $data['key'] = '***';
  $data['url'] = 'https://google.com';
  $data['data'] = base64_encode(
                    json_encode(
                      array(
                        'amount' => '100.00',
                        'description' => 'Product',
                        'currency' => 'UAH'
                      )
                    )
                  );
  $data['payment'] = 'CCT';
  $card_token = '***';
  $sign = md5(
            strtoupper(
              strrev($data['key']).
              strrev($data['payment']).
              strrev($data['data']).
              strrev($data['url']).
              strrev($card_token).
              strrev($pass)
            )
          );
?>

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

В цілях тестування використайтеcard_token отриманий з коллбека при успішній транзакції використовуючи наші тестові реквізити.

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

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

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

10 хв
30 хв
75 хв

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

Оплата в 1 клік по CARD_TOKEN (Client - Server)

Зміст

Опис

Особливості токенів

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