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

note

Содержание

Содержание

note

Описание

Описание

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

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

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

note

Демо

Демо

note

Чеклист интеграции

Чеклист интеграции

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

Требования

Требования

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

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

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

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

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

note

API параметры

API параметры

HTTP METHOD: POST

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

Параметр

Значение

Описание

Особенности

key

String

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

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

payment

P24

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

data

amount

Number

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

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

1000.00

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

1000
1000.0
1,000.0
1,000.00

currency

UAH

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

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

description

String

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

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

Max 5000 символов

url

String

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

Max 255 символов

email

String

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

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

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

Max 255 символа.

phone

Number

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

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

Max 255 символа.

sign

String

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

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

lang

UK
RU
EN

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

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

first_name

String

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

Max 32 символа

last_name

String

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

Max 32 символа

address

String

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

Max 32 символа

zip

String

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

Max 32 символа

city

String

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

Max 32 символа

country

String

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

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

state

String

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

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

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

customer_wallet

String

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

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

order

String

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

Max 32 символа

formid

String

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


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

String

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

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

note

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

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

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

Content-Type: form-data или x-www-form-urlencoded

<?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>
note

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

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

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

note

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

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

note

Callback

Callback

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

note

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

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

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

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

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

md5(
  strtoupper(
    $pass.
    $order_id
  )
)

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

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

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

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

note

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

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