Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

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

...

Table of Contents

...

Описание:

Данный метод позволяет размещать отдельную кнопку для оплаты через Приват24 Privat24 без использования платежной формы.

Note

Добавление атрибута target="_blank" на кнопку оплаты, для открытия Приват24 Privat24 в новом окне, строго запрешено

Note

Оплата Приват24 Privat24 не поддерживает холдирование средств (HOLD)

...

Обязательные требования к сайту:

...

API Endpoint (cсылка для отправки запросов):

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
languagephp
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 для этого запроса запрещено

...

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

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

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

...

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

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

...

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

Tip

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

...

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

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

Code Block
languagephp
array (
  'token' => '12345678',
)

...

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

Info

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

...

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

В ходе проведения запрос вы можете получить разные ошибки. Пожалуйста, ознакомьтесь со списком возможных ошибок, их причин и возможности решения.

...