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

C2AT

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

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).
  )
)

card_token

Status

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

String

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

url

Status

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

String

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

Max 1024 символів

error_url

Status

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

String

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

Max 1024 символів

qr

Status

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

Y

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

lang

Status

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

UK
EN

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

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

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…

formid

Status

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

String

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

Max 255 символів

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
    $pass$client_pass = '***';
    $data['key']= '***';
    $data['action'] = 'CREATE';
    $data['payment'] = 'C2AT';
    $data['order'] = '123ABC';
    $data['description'] = 'ТестоваяТестова оплата';
    $data['amount'] = '356.00';
    $data['urlcard_token'] = '********';
    $data['qr'] = 'https://google.comY';
    $data['card_tokenurl'] = '4645nhj5466hjhfriiriibttri4456https://google.com';
    $data['sign'] = md5(
                        strtoupper(
                            $data['key'].
                            $data['payment'].
                            $data['amount'].
                            strrev($pass$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=C2AT&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

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"
}

Тестирование

Тестування

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

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

Expand

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

Include Page

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

Callback

Expand

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

Include Page

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

Expand

title	Используйте наши тестовые реквизитыБезпека

Include Page

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

Include Page

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

Expand

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

Info

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

Code Block

language	php

array (
  'token' => '11-22-33',
)

Callback при неуспешной оплате

При неуспешной оплате коллбек не отправляетсяurl = https://www.google.com/

order = 12345

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

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

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

Version	Old Version 7	New Version Current
Changes made by	Tech Platon	Tech Platon
Saved on	Dec 01, 2023	Jan 07, 2025

Versions Compared

Key

Зміст

API параметри

Примеры запроса

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

Responce

Тестування

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

Callback

Callback при неуспешной оплате

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