Content Comparison

HTTP METHOD: POST

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

Параметр	Значення	Опис	Особливості
key Status colour Green title Обов'язковий	String	API ключ мерчанта	Ключ надається на пошту мерчанту
order Status colour Yellow title не Обов'язковий	String	ID оплати в системі мерчанта	Max 32 символи
action Status colour Green title Обов'язковий	CREATE	Код платіжного метода
payment Status colour Green title Обов'язковий	CC	Ознака еквайрингової оплати
description Status colour Green title Обов'язковий	String	Опис	Note Для кириличних символів необхідно використовувати формат UTF-8 Max 5000 символів
amount Status colour Green title Обов'язковий	Number	Сума оплати	Tip Вірний варіант 1000.00 Warning Невалідні варіанти 1000 1000.0 1,000.0 1,000.00
sign Status colour Green title Обов'язковий	String	Контрольний підпис	Code Block language php md5( strtoupper( $key. $payment. $amount. strrev($pass). ) )
url Status colour Green title Обов'язковий	String	Посилання по якому буде відправлено платника після успішної оплати	Max 1024 символа При відсутності можливості створити вашу власну сторінку успішної оплати можете використати нашу стандартну.
error_url Status colour Yellow title не Обов'язковий	String	Посилання по якому буде відправлено платника після 5 невдалих спроб оплати	При відсутності посилання помилка буде відображеня на платіжній формі. Max 1024 символа При відсутності можливості створити вашу власну сторінку невдалої оплати можете використати нашу стандартну.
lang Status colour Yellow title не Обов'язковий	UK EN	Мова відображення платіжної форми	В приоритеті cookie в браузері клиента з параметром lang Стандарт ISO 639-1
email Status colour Yellow title не Обов'язковий	String	Пошта платника	Max 255 символів
first_name Status colour Yellow title не Обов'язковий	String	Імʼя платника	Max 32 символи
last_name Status colour Yellow title не Обов'язковий	String	Прізвище платника	Max 32 символи
phone Status colour Yellow title не Обов'язковий	Number	Номер телефону платника	Info Обов'язковий формат телефону 380… Max 255 символів
formid Status colour Yellow title не Обов'язковий	String	Параметр додаткового налаштування	Max 255 символів
recurring Status colour Yellow title не Обов'язковий	Y	Створення токена картки	Для отримання rc_id та rc_token
req_token Status colour Yellow title не Обов'язковий	Y	Створення токена картки	Для отримання card_token
ext1, ext2, ext3, ext4, ext5, ext6, ext7, ext8, ext9 Status colour Yellow title не Обов'язковий		9 додаткових полів	Max 1024 символа в кожному з 9 ext полів
date_ran Status colour Yellow title не Обов'язковий	String	Дата та час активації короткого посилання для можливості оплати	Tip Час по Києву. Info Обов'язковий формат часу YYYY-MM-DD HH:MM:SS Стандартно коротке посилання активне з моменту створення Expand title Приклад помилки, яку побачить клієнт
date_end Status colour Yellow title не Обов'язковий	String	Дата та час деактивації короткого посилання для заборони можливості оплати	Tip Час по Києву. Info Обов'язковий формат часу YYYY-MM-DD HH:MM:SS Note Стандартно коротке посилання активне до 2099-12-31 23:59:59 Expand title Приклад помилки, яку побачить клієнт
qr Status colour Yellow title не Обов'язковий	Y	Отримати картинку з QR кодом	Картинку необхідно буде завантажити на ваш сервер
deactivate Status colour Yellow title не Обов'язковий	Y	Деактивація короткого посилання після успішної оплати	Використовується для заборони повторної оплати по тому ж короткому посиланню декілька разів

---

<?php
   $pass $client_pass = '***';
    $data['key']= '***';
    $data['action'] = 'CREATE';
    $data['payment'] = 'CC';
    $data['order'] = '123ABC';
    $data['description'] = 'ТестоваяТестова оплата';
    $data['amount'] = '356.00';
    $data['qr'] = 'Y';
    $data['url'] = 'https://google.com';
    $data['sign'] = md5(strtoupper(
       $data['key'].     $data['payment'].     $data['amount'].       strrevstrtoupper($pass)
  ));       $url = 'https://secure.platononline.com/post-invoice/';   $crq = curl_init();     curl_setopt($crq, CURLOPT_URL, $url);     curl_setopt($crq, CURLOPT_HEADER, 0);$data['key'].
      curl_setopt($crq, CURLOPT_POST, 1);     curl_setopt($crq, CURLOPT_RETURNTRANSFER, 1);     curl_setopt($crq, CURLOPT_SSL_VERIFYHOST, 0);     curl_setopt($crq, CURLOPT_SSL_VERIFYPEER, 0); $data['payment'].
         curl_setopt($crq, CURLOPT_POSTFIELDS, http_build_query($data));   $result = curl_exec($crq);   if (curl_errno($crq)) {     echo 'ERROR: $data['.curl_error($crq);amount'].
  }else{     echo $result;   }   curl_close($crq);

var url = "https://secure.platononline.com/post-invoice/";  var httpRequest = (HttpWebRequest)WebRequest.Create(url);
httpRequest.Method = "POST";

httpRequest.ContentType = "application/x-www-form-urlencoded";

var data = "key=*****&action=create&order=123ABC&description=Test%20Payment&amount=356.00&qr=Y&sign=*********************";

using (var streamWriter = new StreamWriter(httpRequest.GetRequestStream()))
  {
    streamWriter.Write(data);
  }

var httpResponse = (HttpWebResponse)httpRequest.GetResponse();
using (var streamReader = new StreamReader(httpResponse.GetResponseStream()))
  {
    var result = streamReader.ReadToEnd();
  }

{
  "action":"CREATE",
  "result":"SUCCESS",
  "short_link":"https:\/\/secure.platononline.com\/payment\/shortlink\/655f00d39169657856757",
  "upload_qr":"https:\/\/pltn.me\/v3\/qr\/qr_655f00d39169657856757.png"
}

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

array (
  'id' => '27374-54220-93708',
  'order' => '11-22-33',
  'status' => 'SALE',
  'rrn' => NULL,
  'approval_code' => NULL,
  'card' => '411111****1111',
  'description' => 'Оплата триал версии',
  'amount' => '1.00',
  'currency' => 'UAH',
  'name' => 'Марина Иванова',
  'email' => 'platon@gmail.com',
  'country' => NULL,
  'state' => NULL,
  'city' => NULL,
  'address' => NULL,
  'date'=> '2019-11-14 15:30:22',
  'ip' => '155.209.55.69',
  'sign' => '********************************',
  'rc_id' => '27374-54220-93708',
  'rc_token' => 'b2ef4d1061621ffc0ed12d00c155ec93',
  'card_token' => '85351eeec95ebc2fef8a210ab5c9818e64157460af4600ce1210508f08f87433',
  'fee_type' => 'TRANSACTION',
  'fee' => '0.5',
)

Параметр

Опис

id

Унікальний ордер ID транзакції в Platon

order

Ордер ID транзакції в системі мерчанта. Якщо параметр не передавався система Platon присвоїт його самостійно

status

SALE

rrn

Значення RRN транзакції

approval_code

Значення approval_code транзакції

card

Маска картки в форматі ХХХХХХ****ХХХХ, або маска телефону при оплаті частинами

description

Опис

amount

Сума оплати

currency

UAH

name

Сума переданих параметрів first_name та last_name

email

E-mail платника

country

Код країни платника (2-а знака)

state

Код штата платника (2-х або 3-х значний код)

city

Місто платника

address

Адреса платника

date

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

ip

IP адреса платника

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

Додаткові поля

rc_id

Ордер ID в системі Platon для наступних транзакцій по rc_token

rc_token

Зашифрований токен картки для наступних транзакцій по rc_token

card_token

Зашифрований токен картки для наступних транзакцій по card_token

card_hash

Уникальне зашифроване значення номера картки.

Цей параметр дасть вам можливість:

• Прив'язати картку під клієнта.

• Перевірити чи не використовував її інший клієнт.

• Перевірити які кредити, товари та послуги оплачували цією карткою.

• Відслідковувати шахрайство, коли клієнт використовує ту саму картку з іншого акаунта, наприклад, щоб повторно скористатися акцією.

fee_type

Ознака яким чином знімається комісія:

• ACT - по актам.

• TRANSACTION - потранзакційно.

fee

Сума комісії з мерчанта по транзакції в ГРН

issuing_bank

Назва банку емітентка картки клієнта.

brand

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

MID

Унікальний ідентифікатор банківського термінала PSP Paton. Підкожний платіжний метод та мерчанта свій ідентифікатор.

sign

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

md5(
  strtoupper(
    strrev($email).
    $pass.
    $order.
    strrev(
      substr($card,0,6).
      substr($card,-4)
    )
  )
)

array (
  'id' => '27374-54220-93708',
  'order' => '11-22-33',
  'status' => 'SALE',
  'rrn' => NULL,
  'approval_code' => NULL,
  'number' => '411111****11',
  'description' => 'Оплата триал версии',
  'amount' => '1.00',
  'currency' => 'UAH',
  'name' => 'Марина Иванова',
  'email' => 'platon@gmail.com',
  'country' => NULL,
  'state' => NULL,
  'city' => NULL,
  'address' => NULL,
  'date'=> '2019-11-14 15:30:22',
  'ip' => '155.209.55.69',
  'sign' => '********************************',
  'rc_id' => '27374-54220-93708',
  'rc_token' => 'b2ef4d1061621ffc0ed12d00c155ec93',
  'card_token' => '85351eeec95ebc2fef8a210ab5c9818e64157460af4600ce1210508f08f87433',
  'fee_type' => 'TRANSACTION',
  'fee' => '0.5',
)

Параметр

Опис

id

Унікальний ордер ID транзакції в Platon

order

Ордер ID транзакції в системі мерчанта. Якщо параметр не передавався система Platon присвоїт його самостійно

status

SALE

rrn

Значення RRN транзакції

approval_code

Значення approval_code транзакції

number

Маска картки в форматі ХХХХХХ****ХХ

description

Опис

amount

Сума оплати

currency

UAH

name

Сума переданих параметрів first_name та last_name

email

E-mail платника

country

Код країни платника (2-а знака)

state

Код штата платника (2-х або 3-х значний код)

city

Місто платника

address

Адреса платника

date

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

ip

IP адреса платника

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

Додаткові поля

rc_id

Ордер ID в системі Platon для наступних транзакцій по rc_token

rc_token

Зашифрований токен картки для наступних транзакцій по rc_token

card_token

Зашифрований токен картки для наступних транзакцій по card_token

card_hash

Уникальне зашифроване значення номера картки.

Цей параметр дасть вам можливість:

• Прив'язати картку під клієнта.

• Перевірити чи не використовував її інший клієнт.

• Перевірити які кредити, товари та послуги оплачували цією карткою.

• Відслідковувати шахрайство, коли клієнт використовує ту саму картку з іншого акаунта, наприклад, щоб повторно скористатися акцією.

fee_type

Ознака яким чином знімається комісія:

• ACT - по актам.

• TRANSACTION - потранзакційно.

fee

Сума комісії з мерчанта по транзакції в ГРН

issuing_bank

Назва банку емітентка картки клієнта.

brand

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

MID

Унікальний ідентифікатор банківського термінала PSP Paton. Підкожний платіжний метод та мерчанта свій ідентифікатор.

sign

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

md5(
  strtoupper(
    strrev($email).
    $pass.
    $order.
    strrev(
      substr($card,0,6).
      substr($card,-4)
    )
  )
)

При невдалій оплаті:

        strrev($client_pass)
                        )
                    );
   
    $url = 'https://secure.platononline.com/post-invoice/';
    $crq = curl_init();
    curl_setopt($crq, CURLOPT_URL, $url);
    curl_setopt($crq, CURLOPT_HEADER, 0);
    curl_setopt($crq, CURLOPT_POST, 1);
    curl_setopt($crq, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($crq, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($crq, CURLOPT_SSL_VERIFYPEER, 0);
    curl_setopt($crq, CURLOPT_POSTFIELDS, http_build_query($data));
    $result = curl_exec($crq);
        if (curl_errno($crq)) {
            echo 'ERROR: '.curl_error($crq);
        }else{
        echo $result;
        }
    curl_close($crq);

var url = "https://secure.platononline.com/post-invoice/";

var httpRequest = (HttpWebRequest)WebRequest.Create(url);
httpRequest.Method = "POST";

httpRequest.ContentType = "application/x-www-form-urlencoded";

var data = "key=*****&action=CREATE&payment=CC&order=123ABC&description=Test%20Payment&amount=356.00&qr=Y&sign=*********************";

using (var streamWriter = new StreamWriter(httpRequest.GetRequestStream()))
  {
    streamWriter.Write(data);
  }

var httpResponse = (HttpWebResponse)httpRequest.GetResponse();
using (var streamReader = new StreamReader(httpResponse.GetResponseStream()))
  {
    var result = streamReader.ReadToEnd();
  }

{
  "action":"CREATE",
  "result":"SUCCESS",
  "short_link":"https:\/\/secure.platononline.com\/payment\/shortlink\/655f00d39169657856757",
  "upload_qr":"https:\/\/pltn.me\/v3\/qr\/qr_655f00d39169657856757.png"
}