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

note

Зміст

Зміст

note

Опис

Опис

Цей метод дозволить розмістити окрему кнопку для оплати Privat24 без використання платіжної форми.

Заборонено додавати атрибут target="_blank" на кнопку оплати для відкриття Privat24 в новому вікні.

Оплата Privat24 не підтримує холдування коштів (HOLD).

note

Демо

Демо

note

Чекліст інтеграції

Чекліст інтеграції

  • Привести сайт / приложение к соответствию требованиям.
  • Інтегрувати цей API метод.
  • Передати тех підтримці PSP Platon посилання для Callback.
  • Провести оплату реальною карткою (активується після підписання договору).
  • Отримати Callback та змінити статус оплати на вашому сайті.
note

Вимоги

Вимоги

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
EN

Мова відображення платіжної форми

В приоритеті cookie в браузері клиента з параметром lang

Стандарт ISO 639-1

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

Max 2 символи

state

String

Код штату, провінції або області платника

Обов'язковий параметр для країн US, CA, AU

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

Max 3 символа.

customer_wallet

String

Номер електронного гаманця платника

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

order

String

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

Max 32 символи

formid

String

Параметр додаткового налаштування


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

String

10 додаткових полів

Max 1024 символи в кожному ext полі

note

Приклад запиту

Приклад запиту

Запит має відправлятися з браузера платника Client - Server, а не з сервера мерчанта Server - Server.

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>

Postman Collection

note

Тестування

Тестування

В цілях тестування необхідно використовувати реальну картку прив'язану до Privat24.

note

Перевірка платежів

Перевірка платежів

note

Callback

Callback

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

note

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

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

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

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

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

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

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

note

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

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