Page Comparison

Info
Цей функціонал буде активовано після вашого запиту в груповому чаті.

Зміст

Table of Contents

maxLevel	2
indent	0px
absoluteUrl	true
style	circle

Опис

Цей метод дозволить розмістити окрему кнопку для оплати Privat24 без використання платіжної форми.

Note
Заборонено додавати атрибут `target="_blank"` на кнопку оплати для відкриття Privat24 в новому вікні.

Note
Оплата Privat24 не підтримує холдування коштів (HOLD).

Демо

Iframe

scrolling	no
src	https://devplaton.com.ua/invoices/demo_buttons/payment_privat24.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	Обов'язковий

P24

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

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 символів

url

Status

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

String

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

Max 255 символів

email

Status

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

String

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

Info
Обов'язково валідна пошта.

Info
Відсутність пробілів.

Max 255 символів

phone

Status

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

Number

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

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

Max 255 символів

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

Мова відображення платіжної форми

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

Стандарт ISO 639-1

first_name

Status

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

String

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

Max 32 символи

last_name

Status

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

String

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

Max 32 символи

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

Max 2 символи

state

Status

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

String

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

Note
Обов'язковий параметр для країн US, CA, AU

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

Max 3 символа.

customer_wallet

Status

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

String

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

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

order

Status

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

String

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

Max 32 символи

formid

Status

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

String

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

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

Status

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

String

10 додаткових полів

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

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

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' => '100.00',
                        'description' => 'Product',
                        'currency' => 'UAH'
                      )
                    )
                 );
  $data['payment'] = 'P24';
  $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="sign" value="<?=$sign?>" />
    </form>                                         	
  </body>
</html>

Info
Postman Collection

Тестування

В цілях тестування необхідно використовувати реальну картку прив'язану до Privat24.

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

Expand

title	Полный список методов получения результата транзакции

Include Page

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

Callback

Expand

title	Особенности работы с Callback

Include Page

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

Expand

title	Безопасность

Include Page

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

Callback при успешной оплате

Для просмотра примера раскройте список

При успешной оплате:

Expand

title	Пример POST параметров в Callback при успешной оплате

Code Block

language	php

array (
  'id' => '12345-12345-12345',
  'order' => '12345678',
  'status' => 'SALE',
  'description' => 'description 12345',
  'amount' => '99.99',
  'currency' => 'UAH',
  'date' => '2020-02-14 11:11:11',
  'ip' => '172.172.17.172',
  'sign' => 'qwerty123uiop456asdfgh789jkl012z',
  'number' => '411156*89',
  'email' => NULL,
  'name' => ' ',
  'phone' => NULL,
  'ext1' => '12345678',
)

Параметр

Описание

id

Уникальный ордер ID транзакции в Platon

order

Ордер ID транзакции в системе мерчанта. Если параметр не передавался система Platon присвоит его самостоятельно

status

SALE

number

Маска карты в формате ХХХХХХ*ХХ

description

Описание

amount

Сумма списания

currency

Валюта транзакции

name

Сума передаваемых параметров first_name и last_name

email

E-mail плательщика

phone

Телефон плательщика

date

Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)

ip

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

ext1-ext10

Дополнительные поля от 1 до 10

sign

Зашифрованная подпись для проверки достоверности коллбека

Code Blockmd5( strtoupper( $pass. $order_id ) )

Include Page

	Callback / Response - P24
	Callback / Response - P24

Expand

title	Пример GET параметров

Tip
Плательщик будет отправлен по ссылке указанной в `url` с добавлением `order` методом GET

Code Block

language	php

array (
  'token' => '12345678',
)

При неуспешной оплате:

Note
При неуспешной оплате Callback не отправляется.

Ошибки запросов

Expand

title	Список ошибок, их причин и возможных решений.

Include Page

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

Versions Compared

Old Version 78

New Version 79

Key

Зміст

Опис

Демо

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

Вимоги

API параметри

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

Тестування

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

Callback

Callback при успешной оплате

При успешной оплате:

При неуспешной оплате:

Ошибки запросов