Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

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

Info

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


Зміст

Table of Contents
minLevel1
maxLevel2
include
outlinefalse
indent0px
stylecircle
exclude
typelist
class
printablefalse

API параметри

HTTP METHOD: POST

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

Параметр

Значення

Опис

Особливості

key

Status
colourGreen
titleобов'язковий

String

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

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

order

Status
colourGreen
titleобов'язковий

String

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

Max 32 символи

action

Status
colourGreen
titleобов'язковий

CREATE

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

payment

Status
colourGreen
titleобов'язковий

CCT

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

description

Status
colourGreen
titleобов'язковий

String

Опис

Note

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

Max 5000 символов

amount

Status
colourGreen
titleобов'язковий

Number

Сума оплати

Tip

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

1000.00

Warning

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

1000
1000.0
1,000.0
1,000.00

sign

Status
colourGreen
titleобов'язковий

String

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

Code Block
languagephp
md5(
  strtoupper(
    $key.
    $payment.
    $amount.
    strrev($pass).
  )
)

card_token

Status
colourGreen
titleобов'язковий

String

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

url

Status
colourGreen
titleобов'язковий

String

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

Max 1024 символів

error_url

Status
colourYellow
titleне обов'язковий

String

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

Max 1024 символів

qr

Status
colourYellow
titleне обов'язковий

Y

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

lang

Status
colourYellow
titleне обов'язковий

UK
EN

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

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

email

Status
colourYellow
titleне обов'язковий

String

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

Max 255 символів

first_name

Status
colourYellow
titleне обов'язковий

String

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

Max 32 символи

last_name

Status
colourYellow
titleне обов'язковий

String

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

Max 32 символи

phone

Status
colourYellow
titleне обов'язковий

Number

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

Info

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

formid

Status
colourYellow
titleне обов'язковий

String

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

Max 255 символів

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

Status
colourYellow
titleне обов'язковий

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

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

date_ran

Status
colourYellow
titleне обов'язковий

String

Дата и время активации короткой ссылки для возможности оплаты

Tip

Час по Києву.

Info

Обязательный формат времени YYYY-MM-DD HH:MM:SS

По умолчанию короткая ссылка активна с момента создания

date_end

Status
colourYellow
titleне обов'язковий

String

Дата и время деактивации короткой ссылки для предотвращения возможности оплаты

Tip

Время по Киеву.

Info

Обязательный формат времени YYYY-MM-DD HH:MM:SS

Note

По умолчанию короткая ссылка активна до 2099-12-31 23:59:59

deactivate

Status
colourYellow
titleне Обов'язковий

Y

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

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


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

Expand
titleПриклад запиту на PHP
Code Block
languagephp
<?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);
Expand
titleПриклад запиту на .NET
Code Block
languagephp
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();
  }

Responce

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

Тестування

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


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

Expand
titleСписок методів отримання статусу транзакції
Include Page
Отримання результату транзакції
Отримання результату транзакції

Callback

Expand
titleОсобливості роботи з Callback
Include Page
Робота з Callback
Робота з Callback
Expand
titleБезпека
Include Page
Безпека
Безпека

Include Page
Callback / Response - СС та CCT
Callback / Response - СС та CCT
Expand
titleПриклад GET параметрів
Tip

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

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

order = 12345

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

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

Note

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