Page Comparison

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

...

Table of Contents

...

Описание

...

Данный метод позволяет размещать отдельную кнопку для оплаты через Privat24 без использования платежной формы.
...
Note
Оплата Privat24 не поддерживает холдирование средств (HOLD)
...

Демо

...

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

Требования к сайту

...

Добавить логотипы платежных систем Visa и Mastercard
Добавить логотип Privat24
Добавить логотип PSP Platon
...

API

...

Только Form HTML запрос.

...

параметры запроса

HTTP METHOD:

Status

colour	Green
title	POST

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

...

Описание параметров запроса:

Параметр

Значение

Описание

Особенности

Обязательно

key

String

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

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

Да

payment

P24

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

Да

data

amount

Number

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

Tip

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

1000.00

Warning

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

1000
1000.0
1,000.0
1,000.00

Да

currency

UAH

Валюта платежа

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

Да

description

String

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

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

Max 5000 символов

Да

url

String

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

Max 255 символов

Да

sign

String

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

Code Block

language	php

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

Да

lang

UK, RU, EN

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

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

Нет

email

String

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

Max 255 символа

Нет

first_name

String

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

Max 32 символа

Нет

last_name

String

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

Max 32 символа

Нет

phone

Number

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

Note

Если ваше юр. лицо открыто в Приватбанк и вы передаете в запросе телефон плательщика, то:

1) обязательный формат телефона 380…

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

Нет

address

String

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

Max 32 символа

Нет

zip

String

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

Max 32 символа

Нет

city

String

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

Max 32 символа

Нет

country

String

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

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

Нет

state

String

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

Note
Обязательный параметр для стран US, CA, AU

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

Нет

customer_wallet

String

Номер електронного кошелька пользователя

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

Нет

order

String

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

Max 32 символа

Нет

formid

String

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

Нет

ext1-ext10

String

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

Max 1024 символа в каждом ext поле

Нет

...

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

...

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

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

...

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

Дебагинг недоставленных Callback:

С целью дебагинга работы вашего сервера на ошибки получения Callback можем предоставить вам телеграм бот, куда будут поступать тело недоставленных вам Callback и информация об HTTP статусе.

Для настройки телеграм бота обратитесь в ваш груповой чат с просьбой подключить его вам.

...

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

...

Получить информацию о платежах можно такими несколькими способами:
Используя Callback для автоматизации процесса зачисления в системе на вашей стороне.
Нотификация в телеграм бот про успешную оплату с данными платежаTelegram Bot об успешном оплат с деталями платежа сразу после списания.
В вашем личном кабинете Platon.
CSV файл с деталями платежей скачав в личном кабинете Platon.
Письмо об успешном платеже на вашу почту мерчанта и / или плательщика..
Банковский реестр на почту или ваш FTP.

Коллбек при успешной оплате:

Tip
Коллбеки будут поступать с наших IP: 78.140.172.231 62.113.223.114 78.140.135.130 167.99.253.235 185.172.90.66 185.172.90.115 185.172.90.119

Info
Для получения коллбеков отправьте ссылку на ваш обработчик в ваш групповой чат. Ссылка для коллбеков прописывается на стороне Platon.

После отправки коллбека в ответ Platon должен получить код HTTP 200 OK. Если коллбек не удалось доставить будет произведено до 5 попыток повторной отправки в течение 60 секунд.

Опциональные варианты активация которых происходит по вашему обращению в групповом чате:

Коллбеки в формате JSON
Basic Authorization
Отправка Callback на несколько адресов (по умолчанию на один)Дополнительная проверка статуса и деталей платежа по API.

...

Работа с Callback

Info
Рекомендуем ознакомиться с разделом особенностей работы с Callback.

...

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',
)

Info
Для проверки достоверности полученного callback, рекомендуем сверять подпись sign по формуле md5(strtoupper(pass.order_id))

Параметр

Описание

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 ) )

Info
Внимание! Если при запросе на оплату не был указан email, то при проверке sing в подписи Callback следует указать пустое значение для email.

Expand

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

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

Code Block

language	php

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

...

Expand

title	Список ошибок и их решение

Ошибка	Причины	Решение
`Response: {"result":"ERROR","error_message":"Incorrect sign"}`	Неверно сформирована зашифрованная подпись.	Проверьте верность сформированной подписи. Если ошибку не нашли обратитесь в тех поддержку.
	Добавлены параметры, которые не входят в данный запрос.	Проверьте список передаваемых параметров. Если ошибку не нашли обратитесь в тех поддержку.
	Неверно зашифрована data.	Проверить используете ли вы UTF-8 и верный формат параметров.
`Response: {"result":"ERROR","error_message":"Empty action"}`	Параметр action заполнен не верно, пуст, или не на первом месте в списке параметров запроса.	Проверьте список передаваемых параметров. Если ошибку не нашли обратитесь в тех поддержку.
`Response: {"result":"ERROR","error_message":"Order already exists"}`	Значение order_id должно быть уникальным. Данная ошибка говорит о том, что у вас уже была успешная транзакция с таким order_id.	Заменить значение order_id на новое уникальное.
`Response: {"result":"ERROR","error_message":"Service error"}`	Ситуация требует внимания сотрудников Platon.	Рекомендуем обратиться в тех саппорт Platon для проверки причины.
`Response: {"result":"ERROR","error_message":"Previous transaction not completed"}`	Ситуация требует внимания сотрудников Platon.	Рекомендуем обратиться в тех саппорт Platon для проверки причины.

Versions Compared

Old Version 59

New Version 60

Key

Описание

Демо

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

Требования к сайту

Добавить логотипы платежных систем Visa и Mastercard
Добавить логотип Privat24
Добавить логотип PSP Platon
...

API

параметры запроса

Описание параметров запроса:

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

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

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

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

Дебагинг недоставленных Callback:

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

Коллбек при успешной оплате:

Работа с Callback

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

Page Comparison

Versions Compared

Old Version 59

New Version 60

Key

Описание

Демо

Iframescrollingnosrchttps://devplaton.com.ua/invoices/demo_buttons/payment_privat24.phpwidth570frameborderhideheight55...

Требования к сайту

Добавить логотипы платежных систем Visa и MastercardДобавить логотип Privat24Добавить логотип PSP Platon...

API

параметры запроса

Описание параметров запроса:

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

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

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

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

Дебагинг недоставленных Callback:

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

Коллбек при успешной оплате:

Работа с Callback

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

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

Добавить логотипы платежных систем Visa и Mastercard
Добавить логотип Privat24
Добавить логотип PSP Platon
...

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