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

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

Содержание

Описание

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

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

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

Демо

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

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

Требования

SSL сертификат

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

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

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

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

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

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 символов
`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 поле

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

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

Использование 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>

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

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

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

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

Особистий кабінет PSP Platon

Всю необхідну інформацію ви знайдете в нашому особистому кабінеті за посиланням https://secure.platononline.net/auth/login

Подробиці

Інструкція по використанню

Інструкція до особистого кабінету PSP Platon

Помилки доступу в кабінет

Пароль для особистого кабінета актуальний 30 днів. В налаштуваннях кабінету є можливість змінити пароль до кінця терміну його дії, а також нотифікація в останні 10 днів перед закінченням терміну дії старого паролю.

Якщо пароль було втрачено або протерміновано і доступ в кабінет заблоковано, будь ласка, зверніться в груповий чат вказавши логін та email для відправки нового пароля.

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 не отправляется.

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

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

Incorrect sign

Response: {"result":"ERROR","error_message":"Incorrect sign"}

Вариант 1

Неверно сформирована зашифрованная подпись.

Проверьте верность сформированной подписи. Если ошибку не нашли обратитесь в тех поддержку.

Вариант 2

Добавлены параметры, которые не входят в данный запрос.

Проверьте список передаваемых параметров. Если ошибку не нашли обратитесь в тех поддержку.

Вариант 3

Неверно зашифрована data.

Проверить используете ли вы UTF-8 и верный формат параметров.

Empty action

Response: {"result":"ERROR","error_message":"Empty action"}

Вариант 1

Параметр action заполнен не верно, пуст, или не на первом месте в списке параметров запроса.

Проверьте список передаваемых параметров. Если ошибку не нашли обратитесь в тех поддержку.

Вариант 2

Запрос отправляется методом GET, а не POST.

Отправить запрос методом POST.

Order already exists

Response: {"result":"ERROR","error_message":"Order already exists"}

Значение order_id должно быть уникальным. Данная ошибка говорит о том, что у вас уже была успешная транзакция с таким order_id.

Заменить значение order_id на новое уникальное.

Service error

Response: {"result":"ERROR","error_message":"Service error"}

Ситуация требует внимания сотрудников Platon.

Рекомендуем обратиться в тех саппорт Platon для проверки причины.

Previous transaction not completed

Response: {"result":"ERROR","error_message":"Previous transaction not completed"}

Ситуация требует внимания сотрудников Platon.

Рекомендуем обратиться в тех саппорт Platon для проверки причины.

Recurring not supported

Response: {"result":"ERROR","error_message":"Recurring not supported"}

rc_token заблокирован, подробнее о причинах можно узнать в разделе /wiki/spaces/docs/pages/1323303006

Рекомендуем удалить данный rc_token из вашей базы данных и повторить верификацию карты для получения rc_token и возможности проведения транзакций по новому токену.

Initial transaction too old

Response: {"result":"ERROR","error_message":"Initial transaction too old"}

card_token заблокирован, подробнее о причинах можно узнать в разделе /wiki/spaces/docs/pages/1323303006

Рекомендуем удалить данный card_token из вашей базы данных и повторить верификацию карты для получения card_token и возможности проведения транзакций по новому токену.

Account error

Response: {"result":"ERROR","error_message":"Account error"}

Вариант 1

Ваш IP адрес не добавлен в наш белый список.

Обратитесь в тех поддержку для добавления вашего IP в белый список.

Вариант 2

Данный функционал вам не подключен.

Обратитесь в тех поддержку для активации функционала.

Вариант 3

Запрос отправлен не на нужную ссылку.

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

Вариант 4

В запросе указан неверное или несуществующее значение параметра channel_id.

Проверьте передаваемое значение channel_id на достоверность или уточните у тех поддержки доступные у вас значение.

Card token not found for current client

Response: {"result":"ERROR","error_message":"Card token not found for current client"}

Отправка запроса по этому card_token отключена для данного API ключа так как card_token был получен на другом API ключе.

Обратитесь в тех поддержку для решения данной ситуации.

Incorrect hash

Response: {"result":"ERROR","error_message":"Incorrect hash"}

Вариант 1

Неверно сформирована зашифрованная подпись.

Проверьте верность сформированной подписи. Если ошибка не найдена обратитесь в тех поддержку.

Вариант 2

Добавлены параметры, которые не входят в данный запрос.

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

Вариант 3

Запрос был отправлен не с того API ключа по которому был получен rc_token.

Рекомендуем заменить API ключ на тот, по которому был получен rc_token.

Duplicate request

Response: {"result":"ERROR","error_message":"Duplicate request"}

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

Рекомендуем проверить ваш механизм отправки запросов на наличие задвоения.

Incorrect card_token value

Response: {"result":"ERROR","error_message":"Incorrect card_token value"}

Вариант 1

Запрос был отправлен менее чем через 10 минут после получения токена.

Рекомендуем настроить отправку запросов минимум через 10 минут после получения токена. Запрос по которому получена эта ошибка необходимо повторить.

Вариант 2

В параметр card_token внесено неверное значение.

Рекомендуем проверить верность внесенных данных в поле card_token полученного из коллбека ранее. Запрос по которому получена эта ошибка необходимо повторить.

Not found card token

Response: {"result":"ERROR","error_message":"Not found card token"}

Вариант 1

Запрос был отправлен менее чем через 10 минут после получения токена.

Рекомендуем настроить отправку запросов минимум через 10 минут после получения токена. Запрос по которому получена эта ошибка необходимо повторить.

Вариант 2

В параметр card_token внесено неверное значение.

Рекомендуем проверить верность внесенных данных в поле card_token полученного из коллбека ранее. Запрос по которому получена эта ошибка необходимо повторить.

102: Token is not active

'decline_reason' => '102: Token is not active'

rc_token заблокирован, подробнее о причинах можно узнать в разделе /wiki/spaces/docs/pages/1323303006

Рекомендуем удалить данный rc_token из вашей базы данных и повторить верификацию карты для получения rc_token и возможности проведения транзакций по новому токену.

Wrong credit_date

'error_message' => 'Wrong credit_date'

credit_date введен не согласно формата YYYY-MM-DD или указана будущая дата.

Рекомендуем указать в credit_date прошедшую дату или текущую.

Invalid pan

'error_message' => 'Invalid pan'

Invalid pan введен не верный номер карты.

Сверьте номер карты. Рекомендуем проверять номер карты на действительность перед отправкой в запросе используя алгоритм Луна.

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

Содержание

Описание

Демо

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

Требования

PSP Platon

Visa

Mastercard

Простір

Оплата частинами Monobank

Оплата частинами ПриватБанк

PCI DSS

Apple Pay

Google Pay

Privat24

API параметры

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

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

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

Callback & Response

Telegram Bot

Особистий кабінет PSP Platon

Інструкція по використанню

Помилки доступу в кабінет

CSV файл

Банківський реєстр

API запит статуса

Callback

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

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

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

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

Вариант 1

Вариант 2

Вариант 3

Вариант 1

Вариант 2

Вариант 1

Вариант 2

Вариант 3

Вариант 4

Вариант 1

Вариант 2

Вариант 3

Вариант 1

Вариант 2

Вариант 1

Вариант 2