Page Comparison

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

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

Зміст

Table of Contents

minLevel	1
maxLevel	2
include
outline	false
indent	0px
style	circle
exclude
type	list
class
printable	false

API параметри

HTTP METHOD: POST

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

Параметр

Значення

Опис

Особливості

key

Status

colour	Green
title	обов'язковий

String

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

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

order

Status

colour	Green
title	обов'язковий

String

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

Max 32 символи

action

Status

colour	Green
title	обов'язковий

CREATE

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

payment

Status

colour	Green
title	обов'язковий

C2A

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

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

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

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

email

Status

colour	Yellow
title	не обов'язковий

String

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

Max 255 символів

first_name

Status

colour	Green
title	обов'язковий

String

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

Max 32 символи

last_name

Status

colour	Green
title	обов'язковий

String

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

Max 32 символи

qr

Status

colour	Yellow
title	не обов'язковий

Y

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

phone

Status

colour	Yellow
title	не обов'язковий

Number

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

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

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	не обов'язковий

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

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

date_ran

Status

colour	Yellow
title	не обов'язковий

String

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

Tip
Час по Києву.

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

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

date_end

Status

colour	Yellow
title	не обов'язковий

String

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

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

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

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

deactivate

Status

colour	Yellow
title	не Обов'язковий

Y

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

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

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

Expand

title	Приклад запиту на PHP

Code Block

language	php

<?php
    $client_pass = '***';
    $data['key']= '***';
    $data['action'] = 'CREATE';
    $data['payment'] = 'C2A';
    $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);

Expand

title	Приклад запиту на .NET

Code Block

language	php

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=C2A&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

language	json

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

Тестування

Expand

title	Використайте наші тестові реквізити

Include Page

	Тестові реквізити (C2A)
	Тестові реквізити (C2A)

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

Expand

title	Список методів отримання статусу транзакції

Include Page

	Отримання результату транзакції
	Отримання результату транзакції

Callback

Expand

title	Особливості роботи з Callback

Include Page

	Робота з Callback
	Робота з Callback

Expand

title	Безпека

Include Page

	Безпека
	Безпека

Include Page

	Callback / Response - C2A та С2AT
	Callback / Response - C2A та С2AT

Expand

title	Приклад GET параметрів

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

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

order = 12345

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

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

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

Versions Compared

Old Version 9

New Version Current

Key

Зміст

API параметри

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

Responce

Тестування

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

Callback

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