API інвойс (C2A дебет) NEW

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

Зміст

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 символи
`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);

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

{
  "short_link":"https://pltn.me/E5fih",
  "upload_qr":"https://pltn.me/v1/qr/005_file_85b5d3eb5e7579d0d3b76a74f0d5e61b.png"
}

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

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

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

Номер картки	Місяць / Рік	CVV2	Опис тестових кейсів
4999 9999 9999 0011	05 / 2026	Будь які три цифри	Якщо сума більше 14$ Оплата відбудеться по C2A, по зниженому тарифу.
4000 0000 0000 0002	01 / 2026	Будь які три цифри	Якщо сума більше 14$ Тестування помилки від банку. Платник отримає помилку при першому введенні карткових даних. Ввівши карткові дані повторно в тому ж вікні без перезавантажень сторінки оплата пройде по IE еквайрингу успішно з використанням стандартного тарифу.
4000 0000 0000 0002	01 / 2026	Будь які три цифри	Якщо сума меньше 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 при неуспешной оплате

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