Page Comparison

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

Содержание

Table of Contents

maxLevel	2
indent	0px
absoluteUrl	true
style	circle

Описание

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

Минимальная сумма - отсутствует.

Максимальная сумма - 300 000 грн.

Этот функционал работает в два этапа. При успешном запросе общая сумма попадает в холд, после чего необходимо будет провести подтверждение списания для зачисления средств на ваш счет.

Подтверждение списания возможно несколькими способами:

Вручную в нашем личном кабинете
Настроить на стороне PSP Platon автоматическое списание в срок от 1 часа до 29 дней, о чем просьба сообщить в чат
Настроить автоматическое списание по API запросу списания с холда под вашу бизнес-логику

Warning
Внимание! Подтверждение списания и возврат производится в полном объеме суммы кредита. Частичное списание или частичный возврат запрещены.

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

Привести сайт / приложение к соответствию требованиям.
Передать тех поддержке PSP Platon ссылку для Callback.
Сообщить в тех поддержке PSP Platon ваши IP адреса сервера сайта или о том, что будет использоваться приложение (в этом случае ограничения по IP будут сняты).
Провести интеграцию данного API.
Отобразить клиенту форму для ввода номера телефона, который привязан к Приватбанк.
Отобразить клиенту выбор количества платежей на ваш выбор в в промежутках от 2 до 24 платежей (включительно).
Отправить запрос с вашего сервера / приложения согласно данного API.
Получить Response или Callback со статусом платежа от PSP Platon.
Уведомить клиента об успешном / не успешном запросе на оплату частями.

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

Expand

title	SSL сертифікат

У вашого сайту має бути валідний SSL сертифікат.

Для перевірки валідності та терміну дії вашого SSL сертифіката рекомендуємо скористатися сервісом за посиланням.

Expand

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

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

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

Include Page

	Логотипи для розміщення
	Логотипи для розміщення

Expand

title	TLS 1.2

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

API параметры

HTTP METHOD: POST

API ENDPOINT: https://secure.platononline.com/post/

Параметр

Значение

Описание

Особенности

action

Status

colour	Green
title	обязательно

SALE_PART

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

client_key

Status

colour	Green
title	обязательно

String

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

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

order_id

Status

colour	Green
title	обязательно

String

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

Max 32 символа

order_amount

Status

colour	Green
title	обязательно

Number

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

Tip

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

1000.00

Warning

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

1000
1000.0
1,000.0
1,000.00

order_currency

Status

colour	Green
title	обязательно

UAH

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

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

order_description

Status

colour	Green
title	обязательно

String

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

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

Max 255 символов

payer_ip

Status

colour	Green
title	обязательно

Number

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

В формате "ХХХ.ХХХ.ХХХ.ХХХ"

Note
IPv6 на данный момент не поддерживается

term_url_3ds

Status

colour	Green
title	обязательно

String

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

Max 255 символов

payer_email

Status

colour	Green
title	обязательно

String

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

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

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

Max 255 символа

payer_phone

Status

colour	Green
title	обязательно

Number

Финансовый номер телефона плательщика привязанный к Приватбанк

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

ext4

Status

colour	Green
title	обязательно

String

"{"available_parts_count":"n"}"

JSON с количеством выбранных клиентом платежей от 2 до 24 (включительно), например "{"available_parts_count":"6"}"

channel_id

Status

colour	Green
title	обязательно

privat_parts

Признак оплаты частями монобанк

hash

Status

colour	Green
title	обязательно

String

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

Code Block

language	php

md5(
  strtoupper($pass).
  strrev($order_id)
)

async

Status

colour	Yellow
title	не обязательно

Y
N

Включить асинхронный режим

В асинхронном режиме обязательное использование коллбеков.
По умолчанию значение N

payer_first_name

Status

colour	Yellow
title	не обязательно

String

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

Max 32 символа без пробелов

payer_last_name

Status

colour	Yellow
title	не обязательно

String

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

Max 32 символа без пробелов

payer_address

Status

colour	Yellow
title	не обязательно

String

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

Max 256 символа
Укажите NA, если нет данных

payer_country

Status

colour	Yellow
title	не обязательно

String

Страна плательщика

Стандарт ISO 3166-1 alpha-2
В формате "ХХ"
2 символа
Укажите NA, если нет данных

payer_state

Status

colour	Yellow
title	не обязательно

String

Штат плательщика

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

Стандарт ISO 3166-2
В формате "ХХ"
2 символа
Укажите NA, если нет данных

payer_city

Status

colour	Yellow
title	не обязательно

String

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

Max 32 символа
Укажите NA, если нет данных

payer_zip

Status

colour	Yellow
title	не обязательно

String

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

Max 32 символа
Укажите NA, если нет данных

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

Status

colour	Yellow
title	не обязательно

String

10 дополнительных полей

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

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

Expand

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

Code Block

language	php

<?php
  $client_pass = '***';
  $data['action'] = 'SALE_PART';
  $data['client_key'] = '***';
  $data['order_id'] = '546-4588';
  $data['order_amount'] = '1000.00';
  $data['order_currency'] = 'UAH';
  $data['order_description'] = 'test';
  $data['payer_first_name'] = 'Ivan';
  $data['payer_last_name'] = 'Ivanov';
  $data['payer_phone'] = '+380111111111';
  $data['payer_email'] = 'sale@gmail.com';
  $data['payer_ip'] = '213.186.115.164';
  $data['channel_id'] = 'privat_parts';
  $data['term_url_3ds'] = 'https://google.com';
  $data['ext4'] = '{"available_parts_count":"6"}';
  $hash = md5(
            strtoupper($client_pass).
            strrev($data['order_id'])
          );
?>

<!DOCTYPE html>
<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>sale</title>
  </head>
  <body onload="javascript:document.forms[0].submit()">
    <form action="https://secure.platononline.com/post-unq/" method="post">
      <input type="hidden" name="action" value="<?=$data['action']?>" />
      <input type="hidden" name="client_key" value="<?=$data['client_key']?>" />
      <input type="hidden" name="order_id" value="<?=$data['order_id']?>" />
      <input type="hidden" name="order_amount" value="<?=$data['order_amount']?>" />
      <input type="hidden" name="order_currency" value="<?=$data['order_currency']?>" />
      <input type="hidden" name="order_description" value="<?=$data['order_description']?>" />
      <input type="hidden" name="payer_first_name" value="<?=$data['payer_first_name']?>" />
      <input type="hidden" name="payer_last_name" value="<?=$data['payer_last_name']?>" />
      <input type="hidden" name="payer_phone" value="<?=$data['payer_phone']?>" />
      <input type="hidden" name="payer_email" value="<?=$data['payer_email']?>" />
      <input type="hidden" name="payer_ip" value="<?=$data['payer_ip']?>" />
      <input type="hidden" name="term_url_3ds" value="<?=$data['term_url_3ds']?>" />
      <input type="hidden" name="channel_id" value="<?=$data['channel_id']?>" />
      <input type="hidden" name="ext4" value="<?=$data['ext4']?>" />
      <input type="hidden" name="hash" value="<?=$hash?>" />
    </form>                                             
  </body>
</html>

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

Expand

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

Include Page

	Отримання результату транзакції
	Отримання результату транзакції

Callback

Expand

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

Include Page

	Робота з Callback
	Робота з Callback

Expand

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

Include Page

	Безпека
	Безпека

Синхронный режим:

Данный режим работает по умолчанию. Передавать async = N не нужно.

При успешном редиректе (синхронный режим):

Expand

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

Code Block

language	json

{
  "action":"SALE",
  "result":"REDIRECT",
  "status":"REDIRECT",
  "order_id":"546-45811465476r4367",
  "trans_id":"36618-67917-29503",
  "trans_date":"2022-10-19 13:39:51",
  "redirect_url":"https:\/\/google.com",
  "redirect_params":null,
  "redirect_method":"GET"
}

Expand

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

Code Block

language	json

array (
  'action' => 'SALE',
  'result' => 'REDIRECT',
  'status' => 'REDIRECT',
  'order_id' => '546-45811465476r4367',
  'trans_id' => '36618-67917-29503',
  'trans_date' => '2022-10-19 13:39:51',
  'redirect_url' => 'https:\/\/google.com',
  'redirect_params' => null,
  'redirect_method" => 'GET',
)

При успешной оплате (синхронный режим):

Expand

title	Response при успешном списании

Code Block

language	json

{
  "action":"SALE",
  "result":"SUCCESS",
  "status":"PENDING",
  "order_id":"4385302",
  "trans_id":"28261-34099-19648",
  "descriptor":null,
  "trans_date":"2020-02-25 06:50:09"
}

Параметр	Описание
`action`	`SALE`
`result`	`SUCCESS`
`status`	`PENDING`
`order_id`	Уникальный ордер ID транзакции в системе мерчанта
`trans_id`	Уникальный ордер ID транзакции в системе Platon
`trans_date`	Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)
`descriptor`	NULL

Expand

title	Callback при успешном списании

Code Block

language	php

array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'PENDING',
  'order_id' => '4385323',
  'trans_id' => '28261-47789-28578',
  'trans_date' => '2020-02-25 07:12:58',
  'descriptor' => NULL,
  'hash' => '********************************',
)

Параметр

Описание

action

SALE

result

SUCCESS

status

PENDING

order_id

Уникальный ордер ID транзакции в системе мерчанта

trans_id

Уникальный ордер ID транзакции в системе Platon

trans_date

Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)

descriptor

NULL

hash

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

Code Block
md5( strtoupper( strrev(email). client_pass. trans_id ) )

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

При неуспешной оплате (синхронный режим):

Expand

title	Response при неуспешном списании

Code Block

language	json

{
  "action":"SALE",
  "result":"DECLINED",
  "status":"DECLINED",
  "order_id":"4092002",
  "trans_id":"28076-29879-99538",
  "trans_date":"2020-02-03 20:49:47",
  "decline_reason":"Declined by processing"
}

Параметр	Описание
`action`	`SALE`
`result`	`DECLINED`
`status`	`DECLINED`
`order_id`	Уникальный ордер ID транзакции в системе мерчанта
`trans_id`	Уникальный ордер ID транзакции в системе Platon
`trans_date`	Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)
`descriptor`	NULL
`decline_reason`	Причина отмены транзакции

Expand

title	Callback при неуспешном списании

Code Block

language	php

array (
  'action' => 'SALE',
  'result' => 'DECLINED',
  'status' => 'DECLINED',
  'order_id' => '4092002',
  'trans_id' => '28076-29879-99538',
  'trans_date' => '2020-02-03 20:49:47',
  'decline_reason' => 'Declined by processing',
  'hash' => '********************************',
)

Параметр

Описание

action

SALE

result

DECLINED

status

DECLINED

order_id

Уникальный ордер ID транзакции в системе мерчанта

trans_id

Уникальный ордер ID транзакции в системе Platon

trans_date

Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)

descriptor

NULL

decline_reason

Причина отмены транзакции

hash

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

Code Block
md5( strtoupper( strrev(email). client_pass. trans_id ) )

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

Асинхронный режим:

Данный режим активируется при передаче async = Y. В этом режиме обязательно необходимо принимать callback на ваш callback url.

Промежуточный ответ (асинхронный режим):

Expand

title	Response о принятии запроса в обработку

Code Block

language	json

{
  "action":"SALE",
  "result":"ACCEPTED",
  "order_id":"4385302",
  "trans_id":"28261-34099-19648",
  "trans_date":"2020-02-25 06:50:09"
}

Параметр	Описание
`action`	`SALE`
`result`	`ACCEPTED`
`order_id`	Уникальный ордер ID транзакции в системе мерчанта
`trans_id`	Уникальный ордер ID транзакции в системе Platon
`trans_date`	Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)

При успешном редиректе (aсинхронный режим):

Expand

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

Code Block

language	json

{
  "action":"SALE",
  "result":"REDIRECT",
  "status":"REDIRECT",
  "order_id":"546-45811465476r4367",
  "trans_id":"36618-67917-29503",
  "trans_date":"2022-10-19 13:39:51",
  "redirect_url":"https:\/\/google.com",
  "redirect_params":null,
  "redirect_method":"GET"
}

Expand

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

Code Block

language	json

array (
  'action' => 'SALE',
  'result' => 'REDIRECT',
  'status' => 'REDIRECT',
  'order_id' => '546-45811465476r4367',
  'trans_id' => '36618-67917-29503',
  'trans_date' => '2022-10-19 13:39:51',
  'redirect_url' => 'https:\/\/google.com',
  'redirect_params' => null,
  'redirect_method" => 'GET',
)

При успешной оплате (асинхронный режим):

Expand

title	Callback при успешном списании

Code Block

language	php

array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'PENDING',
  'order_id' => '4385323',
  'trans_id' => '28261-47789-28578',
  'trans_date' => '2020-02-25 07:12:58',
  'descriptor' => NULL,
  'hash' => '********************************',
)

Параметр

Описание

action

SALE

result

SUCCESS

status

PENDING

order_id

Уникальный ордер ID транзакции в системе мерчанта

trans_id

Уникальный ордер ID транзакции в системе Platon

trans_date

Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)

descriptor

NULL

hash

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

Code Block
md5( strtoupper( strrev(email). client_pass. trans_id ) )

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

При неуспешной оплате (асинхронный режим):

Expand

title	Callback при неуспешном списании

Code Block

language	php

array (
  'action' => 'SALE',
  'result' => 'DECLINED',
  'status' => 'DECLINED',
  'order_id' => '4092002',
  'trans_id' => '28076-29879-99538',
  'trans_date' => '2020-02-03 20:49:47',
  'decline_reason' => 'Declined by processing',
  'hash' => '********************************',
)

Параметр

Описание

action

SALE

result

DECLINED

status

DECLINED

order_id

Уникальный ордер ID транзакции в системе мерчанта

trans_id

Уникальный ордер ID транзакции в системе Platon

trans_date

Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)

descriptor

NULL

decline_reason

Причина отмены транзакции

hash

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

Code Block
md5( strtoupper( strrev(email). client_pass. trans_id ) )

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

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

Expand

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

Include Page

	Помилки та рішення при запитах
	Помилки та рішення при запитах

Versions Compared

Old Version 4

New Version 5

Key

Содержание

Описание

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

Рекомендации

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

API параметры

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

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

Callback

Синхронный режим:

При успешном редиректе (синхронный режим):

При успешной оплате (синхронный режим):

При неуспешной оплате (синхронный режим):

Асинхронный режим:

Промежуточный ответ (асинхронный режим):

При успешном редиректе (aсинхронный режим):

При успешной оплате (асинхронный режим):

При неуспешной оплате (асинхронный режим):

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