Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

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

Зміст

API параметри

HTTP METHOD: POST

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

Параметр

Значення

Опис

Особливості

key
ОБОВ'ЯЗКОВИЙ

String

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

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

order
ОБОВ'ЯЗКОВИЙ

String

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

Max 32 символи

action
ОБОВ'ЯЗКОВИЙ

CREATE

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

payment
ОБОВ'ЯЗКОВИЙ

C2A

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

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

url
ОБОВ'ЯЗКОВИЙ

String

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

Max 1024 символів

error_url
НЕ ОБОВ'ЯЗКОВИЙ

String

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

Max 1024 символів

lang
НЕ ОБОВ'ЯЗКОВИЙ

UK
EN

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

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

email
НЕ ОБОВ'ЯЗКОВИЙ

String

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

Max 255 символів

first_name
ОБОВ'ЯЗКОВИЙ

String

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

Max 32 символи

last_name
ОБОВ'ЯЗКОВИЙ

String

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

Max 32 символи

qr
НЕ ОБОВ'ЯЗКОВИЙ

Y

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

phone
НЕ ОБОВ'ЯЗКОВИЙ

Number

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

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

formid
НЕ ОБОВ'ЯЗКОВИЙ

String

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

Max 255 символів

recurring
НЕ ОБОВ'ЯЗКОВИЙ

Y

Створення токену картки

Для отримання rc_id та rc_token

req_token
НЕ ОБОВ'ЯЗКОВИЙ

Y

Створення токену картки

Для отримання card_token

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

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

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

 Пример запроса на 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);

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

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

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

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

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

Номер картки

Місяць / Рік

CVV2

Опис тестових кейсів

4999 9999 9999 0011

05 / 2026

Будь які три цифри

Якщо сума більше 14$

Оплата відбудеться по C2A, по зниженому тарифу.

4000 0000 0000 0002

01 / 2026

Будь які три цифри

Якщо сума більше 14$

Тестування помилки від банку.

Платник отримає помилку при першому введенні карткових даних.

Ввівши карткові дані повторно в тому ж вікні без перезавантажень сторінки оплата пройде по IE еквайрингу успішно з використанням стандартного тарифу.

Якщо сума меньше 14$

Платник проводить оплату без помилок.
Оплата успішно пройде по IE еквайрингу успішно з використанням стандартного тарифу.

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

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

 Пример Callback при успешной оплате по дебету
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',
)

Для проверки достоверности полученного 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 - потранзакционно.

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

fee

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

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

sign

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

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

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

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

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

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

  • No labels