Page Comparison

Зміст

Table of Contents

minLevel	1
maxLevel	2
include
outline	false
indent	0px
style	circle
exclude
type	list
class
printable	false

Опис

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

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

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

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

Демо

Iframe

scrolling	no
src	https://devplaton.com.ua/invoices/demo_buttons/payment_C2AT_CCT.php
width	570
frameborder	hide
height	55

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

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

Вимоги

Expand

title	SSL сертификат

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

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

Expand

title	Логотипы платежных систем и PSP Platon

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

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

Include Page

	Логотипи для розміщення
	Логотипи для розміщення

Expand

title	TLS 1.2

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

API параметри

HTTP METHOD: POST

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

Параметр

Значення

Опис

Особливості

key

Status

colour	Green
title	ОБов'язковий

String

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

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

payment

Status

colour	Green
title	ОБов'язковий

C2AT,CCT

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

amount

Status

colour	Green
title	ОБов'язковий

Number

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

Tip

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

1000.00

Warning

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

1000
1000.0
1,000.0
1,000.00

currency

Status

colour	Green
title	ОБов'язковий

UAH

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

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

description

Status

colour	Green
title	ОБов'язковий

String

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

Max 255 символов

order

Status

colour	Yellow
title	не ОБов'язковий

String

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

Max 32 символа

email

Status

colour	Green
title	ОБов'язковий

String

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

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

phone

Status

colour	Green
title	ОБов'язковий

Number

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

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

card_token

Status

colour	Green
title	ОБов'язковий

String

Токен карты

card_token из коллбека первичной транзакции

url

Status

colour	Green
title	ОБов'язковий

String

Ссылка по которой будет отправлен клиент после успешной оплаты

Max 1024 символа

sign

Status

colour	Green
title	ОБов'язковий

String

Контрольная подпись

Code Block

language	php

md5(
  strtoupper(
    strrev($key).
    strrev($payment).
    strrev($amount).
    strrev($currency).
    strrev($description).
    strrev($url).
    strrev($password)
  )
)

error_url

Status

colour	Yellow
title	не ОБов'язковий

String

Ссылка по которой будет отправлен плательщик после 5 неудачных попыток оплаты

При отсутствии ссылки ошибка будет отображена на платежной форме

first_name

Status

colour	Green
title	ОБов'язковий

String

Имя плательщика

Max 32 символа

last_name

Status

colour	Green
title	ОБов'язковий

String

Фамилия плательщика

Max 32 символа

address

Status

colour	Yellow
title	не ОБов'язковий

String

Адрес плательщика

Max 255 символа

zip

Status

colour	Yellow
title	не ОБов'язковий

String

Почтовый код плательщика

Max 32 символа

city

Status

colour	Yellow
title	не ОБов'язковий

String

Город плательщика

Max 32 символа

country

Status

colour	Yellow
title	не ОБов'язковий

String

Двухзначный код страны плательщика

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

state

Status

colour	Yellow
title	не ОБов'язковий

String

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

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

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

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

lang

Status

colour	Yellow
title	не ОБов'язковий

UK
RU
EN

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

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

formid

Status

colour	Yellow
title	не ОБов'язковий

String

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

Max 255 символов

itn

Status

colour	Yellow
title	не ОБов'язковий

String

ІПН платника

ext1, ext2, ext3, ext4

Status

colour	Yellow
title	не ОБов'язковий

String

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

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

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

Expand

title	Приклад запиту на PHP

Code Block

language	php

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

Тестування

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

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

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

Expand

title	Альтернативний час платіжної сесії

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

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

10 хв
30 хв
75 хв

Callback

Expand

title	Особливості роботи з Callback

Include Page

	Робота з Callback
	Робота з Callback

Expand

title	Безпека

Include Page

	Безпека
	Безпека

Include Page

	Callback / Response - C2A та С2AT
	Callback / Response - C2A та С2AT

Include Page

	Callback / Response - СС та CCT
	Callback / Response - СС та CCT

Expand

title	Приклад GET параметрів

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

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

order = 12345

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

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

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

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

Expand

title	Список помилок та рішень

Include Page

	Помилки та рішення при запитах
	Помилки та рішення при запитах

Versions Compared

Old Version 57

New Version Current

Key

Зміст

Опис

Демо

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

Вимоги

API параметри

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

Тестування

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

Callback

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

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