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

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
RU
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
Использование cURL для этого запроса запрещеноЗапит має відправлятися з браузера платника 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.

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

Тестування

В цілях тестування необхідно використовувати реальну картку прив'язану до 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 Block
md5( strtoupper( $pass. $order_id ) )

Expand

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

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

Code Block

language	php

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

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

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

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

Expand

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

Include Page

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

Versions Compared

Old Version 73

New Version 74

Key

Зміст

Опис

Демо

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

Вимоги

API

параметри

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

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

Тестування

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

Callback

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

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

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

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