Оплата Privat24 отдельной кнопкой

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

Содержание

Описание

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

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

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

Демо

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

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

Требования

SSL сертификат

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

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

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

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

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

Unable to render {include} The included page could not be found.

TLS 1.2

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

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 символов
`sign` ОБЯЗАТЕЛЬНО		String	Контрольная подпись	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	Номер телефона плательщика	Если ваше юр. лицо открыто в Приватбанк и вы передаете в запросе телефон плательщика, то: 1) обязательный формат телефона 380… 2) номер телефона должен соответствовать финансовому номеру привязанному к карте
`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 поле

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

Пример запроса на PHP

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

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

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

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

Unable to render {include} The included page could not be found.

Callback

Особенности работы с Callback

Unable to render {include} The included page could not be found.

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

Unable to render {include} The included page could not be found.

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

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

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

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

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

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

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

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

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

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

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

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

Unable to render {include} The included page could not be found.