View Source

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

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

note

Зміст

note

API параметри

HTTP METHOD: POST

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

Параметр

Значення

Опис

Особливості

key

String

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

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

order

String

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

Max 32 символи

action

CREATE

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

payment

CCT

Ознака дебетової оплати

description

String

Опис

Для кириличних символів необхідно використовувати формат UTF-8

Max 5000 символов

amount

Number

Сума оплати

Вірний варіант

1000.00

Невалідні варіанти

1000
1000.0
1,000.0
1,000.00

sign

String

Контрольний підпис

md5(
  strtoupper(
    $key.
    $payment.
    $amount.
    strrev($pass).
  )
)

card_token

String

Токен отриманий з попередньої оплати

url

String

Посилання по якому буде відправлено клієнта після успішної оплати

Max 1024 символів

error_url

String

Посилання по якому буде відправлено клієнта після 5 невдалих спроб оплати

Max 1024 символів

qr

Y

Створення посилання на картинку з QR кодом

lang

UK
EN

Мова відображення форми

В пріорітеті налаштування браузера клієнта

email

String

Пошта платника

Max 255 символів

first_name

String

Ім'я платника

Max 32 символи

last_name

String

Прізвище платника

Max 32 символи

phone

Number

Номер телефону платника

Обов'язковий формат телефону 380…

formid

String

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

Max 255 символів

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

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

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

date_ran

String

Дата і час активації короткого посилання для можливості оплати

Час по Києву.

Обов'язковий формат часу

YYYY-MM-DD HH:MM:SS

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

date_end

String

Дата та час деактивації короткого посилання для запобігання можливості оплати.

Час по Києву.

Обов'язковий формат часу

YYYY-MM-DD HH:MM:SS

За замовчуванням коротке посилання активне до 2099-12-31 23:59:59.

deactivate

Y

Деактивація короткого посилання після успішної оплати

Використовується для заборони повторної оплати по тому ж короткому посиланню декілька разів

note

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

<?php
    $client_pass = '***';
    $data['key']= '***';
    $data['action'] = 'CREATE';
    $data['payment'] = 'CCT';
    $data['order'] = '123ABC';
    $data['description'] = 'Тестова оплата';
    $data['amount'] = '356.00';
    $data['card_token'] = '********';
    $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=CCT&card_token=****&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();
  }

note

Responce

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

note

Тестування

Для тестування використайте card_token створений на тестовій картці.

note

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

note

Callback

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

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

order = 12345

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

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

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