note

Зміст

Зміст

note

Опис

Опис

Данный метод позволяет получить преимущество при оплате используя пониженный тариф по Дебету.

Со стороны плательщика проводится упрощенная оплата с вводом только CVV.

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

Дополнительно рекомендуем ознакомиться с разделом /wiki/spaces/docs/pages/1323303006

note

Демо

Демо

note

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

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

  • Привести сайт / додаток до відповідності вимогам.
  • Провести інтеграцію відповідно до цього API методу.
  • Передати тех підтримці PSP Platon посилання для Callback.
  • Провести оплату використовуючи CARD_TOKEN отриманий при оплаті / виплаті тестовими реквізитами / реальную карту (активується після підписання договору).
  • Отримати Callback та змінити статус оплати у вашій системі.
note

Вимоги

Вимоги

У вашего сайта должен быть SSL сертификат.

Для проверки валидности и срока действия вашего SSL сертификата рекомендуем воспользоваться сервисом по ссылке.

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

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

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

note

API параметри

API параметри

HTTP METHOD: POST

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

Параметр

Значення

Опис

Особливості

key

String

API ключ мерчанта

Ключ предоставляется на почту мерчанту

payment

C2AT,CCT

Код платежного метода

amount

Number

Сумма платежа

Верный вариант

1000.00

Неверные варианты

1000
1000.0
1,000.0
1,000.00

currency

UAH

Валюта платежа

Оплата возможна только в национальной валюте гривне

description

String

Описание платежа

Max 255 символов

order

String

ID платежа в системе мерчанта

Max 32 символа

email

String

Почта плательщика

Оставить пустое значение, если нет данных

phone

Number

Номер телефона плательщика

Обязательный формат телефона 380…

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($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

Код штата, провинции или области плательщика

Обязательный параметр для стран US, CA, AU

Стандарт ISO 3166-2

Значение NA если нет штата

lang

UK
RU
EN

Язык отображения формы

В приоритете настройка языка браузера плательщика

formid

String

Параметр дополнительной настройки

Max 255 символов

itn

String

ІПН платника

ext1, ext2, ext3, ext4

String

Дополнительные поля

Max 1024 символа в каждом ext поле

note

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

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

<?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>
note

Тестування

Тестування

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

note

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

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

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

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

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

  • 10 хв

  • 30 хв

  • 75 хв

note

Callback

Callback

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

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

order = 12345

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

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

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

note

Помилки запитів

Помилки запитів