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 параметры

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

Требования

Expand

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

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

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

Expand

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

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

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

Include PageЛоготипы для размещенияЛоготипы для размещения

Expand

title	TLS 1.2

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

Отримати Callback та змінити статус оплати на вашому сайті.

Вимоги

Include Page

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

API параметри

HTTP METHOD: POST

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

Параметр

Значение

Значення

Описание

Опис

Особенности

Особливості

key

Status

title
colour	Green

Обязательно

Обов'язковий

String

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

Ключ

предоставляется

надається на

почту мерчанту

пошту мерчанта

payment

Status

title
colour	Green

Обязательно

Обов'язковий

P24

Код

платежного

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

data

Status

title
colour	Green

Обязательно

Обов'язковий

amount

Status

title
colour	Green

Обязательно

Обов'язковий

Number

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

Сума оплати

Tip

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

Вірний варіант

1000.00

Warning

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

Невалідні варіанти

1000
1000.0
1,000.0
1,000.00

currency

Status

title
colour	Green

Обязательно

Обов'язковий

UAH

Валюта

платежа

Info
Оплата

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

можлива лише в національній валюті гривні.

description

Status

title
colour	Green

Обязательно

Обов'язковий

String

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

Опис

Note
Для

кириллических символов необходимо использовать

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

Max 5000

символов

символів

url

Status

title
colour	Green

Обязательно

Обов'язковий

String

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

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

Max 255

символов

символів

email

Status

title
colour	Green

ОБЯЗАТЕЛЬНО

Обов'язковий

String

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

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

Info

Обязательно валидная почта

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

Info

Отсутствие пробелов

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

Max 255

символа.

символів

phone

Status

title
colour	Green

ОБЯЗАТЕЛЬНО

Обов'язковий

Number

Номер

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

телефону платника

Info

Обязательный

Обов'язковий формат

телефона

телефону 380…

info

Номер телефона должен соответствовать финансовому номеру привязанному к карте.

Max 255

символа.

символів

sign

Status

title
colour	Green

Обязательно

Обов'язковий

String

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

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

Code Block

language	php

md5(
  strtoupper(
    strrev(

key

$key).
    strrev(

payment

$payment).
    strrev(

data

$data).
    strrev(

url

$url).
    strrev(

pass

$pass)
  )
)

lang

Status

title
colour	Yellow

НЕ Обязательно

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

UK

RU

EN

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

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

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

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

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

first_name

Status

title
colour	Yellow

НЕ Обязательно

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

String

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

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

Max 32

символа

символи

last_name

Status

title
colour	Yellow

НЕ Обязательно

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

String

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

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

Max 32

символа

символи

address

Status

title
colour	Yellow

НЕ Обязательно

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

String

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

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

Max 32

символа

символи

zip

Status

title
colour	Yellow

НЕ Обязательно

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

String

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

Поштовий індекс платника

Max 32

символа

символи

city

Status

title
colour	Yellow

НЕ Обязательно

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

String

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

Місто платника

Max 32

символа

символи

country

Status

title
colour	Yellow

НЕ Обязательно

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

String

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

Код країни платника

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

Max 2 символи

state

Status

title
colour	Yellow

НЕ Обязательно

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

String

Код

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

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

Note

Обязательный

Обов'язковий параметр для

стран

країн US, CA, AU

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

Max 3 символа.

customer_wallet

Status

title
colour	Yellow

НЕ Обязательно

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

String

Номер електронного

кошелька пользователя

гаманця платника

Поле

обязательно для типов бизнеса связанных с виртуальными

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

order

Status

title
colour	Yellow

НЕ Обязательно

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

String

ID

платежа

оплати в

системе

системі мерчанта

Max 32

символа

символи

formid

Status

title
colour	Yellow

НЕ Обязательно

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

String

Параметр

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

додаткового налаштування

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

Status

colour	Yellow
title	не

обязательно

Обов'язковий

String

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

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

Max 1024

символа

символи в

каждом

кожному ext

поле

полі

Примеры запроса

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

Expand

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

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

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>

Тестирование

В целях тестирования необходимо использовать реальную карту привязанную к Приват24.

Проверка платежей

Info
Postman Collection

Тестування

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

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

Expand

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

Include Page

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

Callback

Expand

title	Особенности работы с Особливості роботи з Callback

Include Page

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

Expand

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

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 Block
md5( strtoupper( $pass. $order_id ) )

Expand

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

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

Include Page

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

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

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

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

Безпека

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 71

New Version Current

Key

Зміст

Опис

Демо

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

Требования

Вимоги

API параметри

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

Тестирование

Тестування

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

Callback

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

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

При

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

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