Page Comparison

Зміст

Table of Contents

maxLevel	2
indent	0px
absoluteUrl	true
style	circle

Опис

Info
Стандартно підключається нульова верифікація - це значить, що з картки клієнта не буде проведено фактичного списання.

Верифікація картки використовується для:

Підтвердження особистості власника картки.
Отримання токенів card_token для подальших виплат та списань.

Tip
Нульова верифікація працює на всіх існуючих картках.

Tip
Одну картку можна верифікувати багато разів. Всі `card_token` отримані при кожній верифікації будуть різні та активні для подальшого використання.

При традиційній верифікації списується сума до 1.00 грн. Якщо коштів недостатньо, то система отримає відмову від банку і як результат верифікація буде не успішна.П

При нульовій верифікації в запиті вказується 10.00 40 грн, але фактичного списання з платника не відбувається. В банківській виписці буде вказано 0 грн.

Налаштування нульової верифікації:

Налаштування нульової верифіккації верифікації відбувається на боці PSP Platon.

Warning
Передавати в запиті `amount = 0.00` заборонено.

Note

При нульовій верифікації повернення проводити не потрібно.

Якщо ви використовуєте після успішної верифікації введення клієнтом суми списання, то таку перевірку необхідно прибрати.

Демо

Iframe

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

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

Привести сайт / додаток відповідно до вимог.
Інтегрувати API метод.
Передати тех підтримці PSP Platon посилання для Callback.
Провести оплату використовуючи реальну карту.
Отримати 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	ОБов'язковий

CC

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

data

Status

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

amount

Status

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

10.0040

Сума оплати

Info
Вказати 10.00 40 грн. Фактичног Фактичного списання не відбудеться.

Warning
Запрещено указывать Заборонено вказувати 0.

currency

Status

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

UAH

Валюта оплати

Info
Верифікація лише в національній валюті гривні.

description

Status

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

String

Опис оплати

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

Max 5000 символов

recurring

Status

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

Y

Створення токену картки

Для отримання rc_id та rc_token

url

Status

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

String

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

Max 255 символів

formid

Status

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

verify

Ознака верифікації

email

Status

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

String

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

req_token

Status

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

Y

Створення токену картки

Для отримання card_token

sign

Status

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

String

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

Code Block

language	php

md5(
  strtoupper(
    strrev($key).
    strrev($payment).
    strrev($data).
    strrev($url).
    strrev($pass)
  )
)

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

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

Note
Обов'язковий формат телефону 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

Код штату, провінції або області платника

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

customer_wallet

Status

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

String

Номер електронного гаманця користувача

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

order

Status

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

String

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

Max 32 символи

error_url

Status

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

String

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

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

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

Status

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

String

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

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

bank_id

Status

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

yes

Включення Bank ID

/wiki/spaces/docs/pages/1326186578

payer_id

Status

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

yes

Включення Payer ID

/wiki/spaces/docs/pages/1324909182

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

Expand

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

Warning
Запит має відправлятися з браузера платника Client - Server, а не з сервера мерчанта Server - Server.

Info
Content-Type: `form-data` або `x-www-form-urlencoded`

Code Block

language	php

<?php
  $pass = '***';
  $data['key'] = '***';
  $data['url'] = 'http://google.com';
  $data['data'] = base64_encode(
                    json_encode(
                      array(
                        'amount' => '10.0040',
                        'description' => 'Payment',
                        'currency' => 'UAH',
                        'recurring' => 'Y'
                      )
                    )
                 );
  $data['payment'] = 'CC';
  $formid = 'verify';
  $req_token = 'Y';
  $sign = md5(
            strtoupper(
              strrev($data['key']).
              strrev($data['payment']).
              strrev($data['data']).
              strrev($data['url']).
              strrev($pass)
            )
          );
?>

<!DOCTYPE html>
<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>Payment</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="data" value="<?=$data['data']?>" />
    <input type="hidden" name="formid" value="<?=$formid?>" />
    <input type="hidden" name="req_token" value="<?=$req_token?>" />
    <input type="hidden" name="sign" value="<?=$sign?>" />
    </form>                                         	
  </body>
</html>

Тестування

Тестування нульової верифікації відбувається лише реальною карткою.

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

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

Expand

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

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

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

10 хв
30 хв
75 хв

Callback

Expand

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

Include Page

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

Expand

title	Безпека

Include Page

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

Note
Для эквайера Приватбанк - в Callback в параметре `amount` будет не указано `0.00`, а первоначальная сумма `10.0040` из запроса верификации.

Note
Для эквайера Аваль - в Callback в параметре `amount` будет указано `0.00`, а не первоначальная сумма `10.0040` из запроса верификации.

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 125

New Version Current

Key

Зміст

Опис

Налаштування нульової верифікації:

Демо

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

Вимоги

API параметри

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

Тестування

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

Callback

При невдалій верифікації:

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