API інвойс (IA) NEW

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

Мерчанту необхідно надати IP серверів для додавання в білий список.

Зміст

1 Зміст
2 API параметри
3 Приклад запиту
4 Responce
5 Тестування
6 Перевірка платежів
7 Callback

API параметри

HTTP METHOD: POST

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

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

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

<?php
    $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'].
                            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();
  }

Responce

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

Тестування

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

Callback

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

url = https://www.google.com/

order = 12345

Клієнта відправить після успішної оплати на https://www.google.com/?order=12345

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

При невдалій оплаті Callback не відправляється.

Документація