Page Comparison

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

Зміст

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

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

Для просмотра примера раскройте список

Expand

title	Пример запроса на PHP

Code Block

language	php

<?php
  $pass = '***';
  $data['key']= '***';
  $data['action'] = 'CREATE';
  $data['payment'] = 'C2A';
  $data['order'] = '123ABC';
  $data['description'] = 'Тестовая оплата';
  $data['amount'] = '356.00';
  $data['url'] = 'https://google.com';
  $data['sign'] = md5(strtoupper(
    $data['key'].
    $data['payment'].
    $data['amount'].
    strrev($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);

Пример ответа на запрос

Code Block

language	json

{
  "action":"CREATE",
  "result":"SUCCESS",
  "short_link":"https:\/\/pltn.me/E5fihsecure.platononline.com\/payment\/shortlink\/655f00d39169657856757",
  "upload_qr":"https:\/\/pltn.me\/v1v3\/qr\/005qr_file_85b5d3eb5e7579d0d3b76a74f0d5e61b655f00d39169657856757.png"
}

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

Expand

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

Include Page

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

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

Для просмотра примера раскройте список

Expand

title	Пример Callback при успешной оплате по дебету

Code Block

language	php

array (
  'id' => '28270-42158-64788',
  'type' => 'DEBIT',
  'order' => '3522743',
  'status' => 'DEBIT',
  'card' => '****************',
  'description' => 'Payment',
  'amount' => '220.00',
  'total' => '220.00',
  'currency' => 'UAH',
  'name' => ' ',
  'email' => NULL,
  'country' => NULL,
  'state' => NULL,
  'city' => NULL,
  'address' => NULL,
  'date' => '2020-02-26 08:04:16',
  'ip' => '46.133.60.119',
  'sign' => '********************************',
  'card_token' => 'b2641381d45e26c4ef90da14c61537f2983504de73711be0f975d301e1dfd29a',
  'fee_type' => 'TRANSACTION',
  'fee' => '0.5',
)

Info

Для проверки достоверности полученного callback, рекомендуем сверять подпись sign по формуле md5(strtoupper(strrev(email).strrev(password).strrev(order).strrev(substr(card,0,6).substr(card,-4))))

Внимание! Если при запросе на оплату не был указан email, то при проверке sing в подписи коллбека следует указать пустое значение для email.

Параметр

Описание

id

Уникальный ордер ID транзакции в Platon

type

DEBIT

order

Ордер ID транзакции в системе мерчанта. Если параметр не передавался система Platon присвоит его самостоятельно

status

DEBIT

card

Маска карты в формате ХХХХХХ****ХХХХ

description

Описание

amount

Сумма списания

commission

Сумма комиссии

total

Сумма списания и комиссии

currency

Валюта транзакции

name

Сума передаваемых параметров first_name и last_name

email

E-mail плательщика

country

Код страны плательщика (2-а знака)

state

Код штата плательщика (2-х или 3-х значный код)

city

Город плательщика

address

Адрес плательщика

date

Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)

ip

IP адрес плательщика

ext1-ext4

Дополнительные поля от 1 до 4

card_token

Зашифрованный токен карты для последующих транзакций по card_token

card_hash

Уникальное зашифрованное значение карты

fee_type

Признак каким образом взимается комиссия:

ACT - по актам.
TRANSACTION - потранзакционно.

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

fee

Сумма комиссии с мерчанта по транзакции в ГРН

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

sign

Зашифрованная подпись для проверки достоверности коллбека

Expand

title	Пример GET параметров

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

Code Block

language	php

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

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

Info
При неуспешной оплате коллбек не отправляется

Versions Compared

Old Version 3

New Version 4

Key

Зміст

API параметри

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

Пример ответа на запрос

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

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

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