Page Comparison

Зміст

Table of Contents

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

Опис

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

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

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

Tip
По одній і тій же картці токен можна отримати декілька разів. При цьому самі ці токени будуть різні і готові до використання.

Tip
Токен можна використовувати на всіх API ключах та юр. особах.

Tip

Якщо при спробі оплати ви отримали відповідь 102: Token is not active це значить, що токен не активний і провести транзакцію по ньому не можливо. Такий токен потрібно видалити з вашої бази даних та надати клієнту можливість оплати іншою карткою.

Tip
Термін дії CARD_TOKEN відповідає терміну дії картки.

Демо

Iframe

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

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

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

Вимоги

Include Page

	Вимоги до сайтів та додатків
	Вимоги до сайтів та додатків

API параметри

HTTP METHOD: POST

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

Параметр

Значення

Опис

Особливості

key

Status

colour	Green
title	обов'язковий

String

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

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

payment

Status

colour	Green
title	обов'язковий

CCT

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

data

Status

colour	Green
title	обов'язковий

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

Опис

Note
Для кириличних символів необхідно використовувати формат UTF-8

Max 5000 символів

card_token

Status

colour	Green
title	обов'язковий

String

Токен картки

card_token з callback першої оплати

url

Status

colour	Green
title	обов'язковий

String

Посилання по якому буде відправлено клієнта після успішної оплати

Max 255 символів

email

Status

colour	Green
title	обов'язковий

String

Пошта платника

Max 255 символів

sign

Status

colour	Green
title	обов'язковий

String

Контрольний підпис

Code Block

language	php

md5(
  strtoupper(
    strrev($key).
    strrev($payment).
    strrev($data).
    strrev($url).
    strrev($card_token).
    strrev($CLIENT_PASSWORD)
  )
)

lang

Status

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

UK
EN

Мова відображення форми

В пріорітеті налаштування мови браузера платника

first_name

Status

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

String

Ім'я платника

Max 32 символи

last_name

Status

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

String

Прізвище платника

Max 32 символи

phone

Status

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

Number

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

Info
Обов'язковий формат телефону 380…

address

Status

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

String

Адреса платника

Max 32 символи

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

order

Status

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

String

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

Max 32 символи

customer_wallet

Status

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

String

Номер електронного гаманця платника

Поле обов'язкове для типів бізнесу пов'язаних з віртуальними активами

error_url

Status

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

String

Посилання по якому буде відправлено клієнта після 5 невдалих спроб оплати

formid

Status

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

String

Параметр додаткового налаштування

ext1, ext2, ext3, ext4, ext5, ext6, ext7, ext8, ext9, ext10

Status

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

String

Додаткові поля

Max 1024 символів в кожному ext полі

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

Expand

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

Warning
Использование cURL для этого запроса запрещено

Info
Content-Type: `form-data` или `x-www-form-urlencoded`

Code Block

language	php

<?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 секунду оплата стане не доступною та приведе до помилки. Відлік починається з моменту відкриття платіжної форми.

Expand

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

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

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

10 хв
30 хв
75 хв

Перевірка платежів

Expand

title	Список методів отримання статусу транзакції

Include Page

	Отримання результату транзакції
	Отримання результату транзакції

Callback

Expand

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

Include Page

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

Expand

title	Безпека

Include Page

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

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 71

New Version Current

Key

Зміст

Опис

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

Демо

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

Вимоги

API параметри

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

Тестування

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

Перевірка платежів

Callback

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

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