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

Зміст

Опис

Регулярний платіж дозволяє робити списання коштів без участі платника.

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

Вимоги

SSL сертифікат

У вашого сайту має бути валідний SSL сертифікат.

Для перевірки валідності та терміну дії вашого SSL сертифіката рекомендуємо скористатися сервісом за посиланням.

TLS 1.2

Обов'язкова підтримка протоколу TLS не нижче версії 1.2

Логотипи платіжних систем та PSP Platon

У футері вашого сайту необхідно розмістити логотипи платіжних систем та PSP Platon.

У випадку регулярних списань без участі платника

Повідомити платника про умови підписки та регулярних списань та отримати підтвердження про згоду з умовами
Розмістити договір публічної оферти та отримати підтвердження від платника про згоду з умовами
Надати платнику можливість відмінити підписку
Згідно правил МПС дозволена лише одна спроба списання коштів з платника за добу

API параметри

HTTP METHOD: POST

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

Параметр	Значення	Опис	Особливості
`action` ОБОВ'ЯЗКОВИЙ	`SALE`	Код платіжного метода
`client_key` ОБОВ'ЯЗКОВИЙ	String	API ключ мерчанта	Ключ надається на пошту мерчанту
`order_id` ОБОВ'ЯЗКОВИЙ	String	ID оплати в системі мерчанта	Max 32 символи
`order_amount` ОБОВ'ЯЗКОВИЙ	Number	Сума оплати	Вірний варіант 1000.00 Невалідні варіанти 1000 1000.0 1,000.0 1,000.00
`order_currency` ОБОВ'ЯЗКОВИЙ	`UAH`	Валюта	Оплата можлива лише в національній валюті гривні
`order_description` ОБОВ'ЯЗКОВИЙ	String	Опис	Max 255 символів
`card_token` ОБОВ'ЯЗКОВИЙ	String	Токен картки	`card_token` з callback першої оплати
`payer_email` ОБОВ'ЯЗКОВИЙ	String	Пошта платника	Валідна пошта Без пробілів
`payer_ip` ОБОВ'ЯЗКОВИЙ	Number	IP-адрес платника	В форматі "ХХХ.ХХХ.ХХХ.ХХХ" IPv6 не підтримується
`term_url_3ds` ОБОВ'ЯЗКОВИЙ	String	Посилання куди перейде платник після проби оплати (успішної чи невдалої)
`ext3` ОБОВ'ЯЗКОВИЙ	`recurring`	Ознака регулярної оплати
`hash` ОБОВ'ЯЗКОВИЙ	String	Контрольний підпис	md5( strtoupper( strrev($payer_email). $client_pass. strrev($card_token) ) ) Если при первоначальном запросе на оплату не был указан `email`, то следует указать пустое значение для `email`.
`async` НЕ ОБОВ'ЯЗКОВИЙ	`Y` `N`	Включити асинхронний режим	В асинхронному режимі обов'язкове використання коллбеків. Стандартне значення `N`
`channel_id` НЕ ОБОВ'ЯЗКОВИЙ	String	Додатковий платіжний канал	Дозволяє відправити оплати на інший банківський термінал
`payer_first_name` НЕ ОБОВ'ЯЗКОВИЙ	String	Ім'я платника	Max 32 символи без пробілів
`payer_last_name` НЕ ОБОВ'ЯЗКОВИЙ	String	Прізвище платника	Max 32 символи без пробілів
`payer_address` НЕ ОБОВ'ЯЗКОВИЙ	String	Адреса платника	Max 256 символів
`payer_country` НЕ ОБОВ'ЯЗКОВИЙ	String	Країна платника	В форматі "ХХ" Max 2 символи Вкажіть `NA`, якщо немає даних
`payer_state` НЕ ОБОВ'ЯЗКОВИЙ	String	Штат платника	В форматі "ХХ" Max 2 символи Вкажіть `NA`, якщо немає даних
`payer_city` НЕ ОБОВ'ЯЗКОВИЙ	String	Місто платника	Max 32 символи Вкажіть `NA`, якщо немає даних
`payer_zip` НЕ ОБОВ'ЯЗКОВИЙ	String	Поштовий індекс платника	Max 32 символи Вкажіть `NA`, якщо немає даних
`payer_phone` НЕ ОБОВ'ЯЗКОВИЙ	Number	Номер телефону платника	В форматі “380XXXXXXXXX” Max 32 символів
`customer_wallet` НЕ ОБОВ'ЯЗКОВИЙ	String	Номер електронного гаманця платника	Поле обов'язкове для типів бізнесу пов'язаних з віртуальними активами
`auth` НЕ ОБОВ'ЯЗКОВИЙ	`Y` `N`	HOLD коштів	Стандартне значення `N`

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

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

<?php
  $client_pass='***';
  $data['action']='SALE';
  $data['client_key']='***';
  $data['order_id']='458-3453';
  $data['order_amount']='1000.00';
  $data['order_currency']='UAH';
  $data['order_description']='test';
  $data['card_token'] = '*****';
  $data['payer_phone']='380111111111';
  $data['payer_email']='sale@gmail.com';
  $data['payer_ip']='213.186.115.164';
  $data['term_url_3ds']='http://google.com';
  $data['hash'] = md5(
            strtoupper(
              strrev($data['payer_email']).
              $client_pass.
              strrev($data['card_token'])
            )
          );

$url = 'https://secure.platononline.com/post-unq/';
$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);

Postman Collection

Тестування

В цілях тестування використовуйте card_token отриманий з коллбека успішної транзакції по одному з вказаних методів:

IE оплата карткою
Верифікація картки
C2A оплата
Виплата на картку по повному номеру картки

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

Список методів отримання результату транзакцій

Особистий кабінет PSP Platon

Всю необхідну інформацію ви знайдете в нашому особистому кабінеті за посиланням https://secure.platononline.net/auth/login

Подробиці

Інструкція по використанню

Інструкція до особистого кабінету PSP Platon

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

Пароль для особистого кабінета актуальний 30 днів. В налаштуваннях кабінету є можливість змінити пароль до кінця терміну його дії, а також нотифікація в останні 10 днів перед закінченням терміну дії старого паролю.

Якщо пароль було втрачено або протерміновано і доступ в кабінет заблоковано, будь ласка, зверніться в груповий чат вказавши логін та email для відправки нового пароля.

Callback

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

URL для Callback

Для отримання Callback відправте URL на ваш обробник в груповий чат з вказанням API ключа для якого потрібно прописати посилання. Посилання для Callback вказується на боці PSP Platon.

IP адреси

Callback будуть надходити з IP:
78.140.172.231
78.140.135.130
167.99.253.235
62.113.223.114
62.113.223.116
212.83.61.161
185.172.90.66
185.172.90.74
185.172.90.75
185.172.90.115
185.172.90.119

Очікувана відповідь на Callback

Після відправки Callback у відповідь PSP Platon має отримати HTTP код 200.

Помилки при відправці Callback

Якщо Callback не вдалося відправити або було отримано не HTTP код 200, будуть проведені додаткові повторні спроби відправки в проміжках часу 1 хв, 5 хв, 10 хв, 15 хв, 30 хв, 60 хв.

Перевідправка Callback

Для перевідправки Callback прохання повідомити в груповий чат список необхідних ордерів.

Безпека

Увага! Рекоменлації цього розділу допоможуть запезпечити безпеку від шахрайських дій пов'язаних з вашим сайтом та транзакціями.

Довірені IP

Для забезпечення додаткової безпеки рекомендуємо опціонально додати в білий список доступів POST запити тільки з наших довірених IP:
78.140.172.231
78.140.135.130
167.99.253.235
62.113.223.114
62.113.223.116
212.83.61.161
185.172.90.66
185.172.90.74
185.172.90.75
185.172.90.115
185.172.90.119

Секретність API доступів

Не тримайте у відкритому доступі API ключ та API пароль, а також не надавайте обидва ці параметри в групові робочі чати, в тому числі з нами. Для перевірки деталей представники PSP Platon можуть попросити у вас лише API ключ, пароль треба тримати в таємниці.

Секретність кабінету

Не розголошуйте логін та пароль від вашого особистого кабінету третім особам. У випадку якщо доступ був втрачений зверніться в груповий чат. Пароль від особистого кабінету діє 30 днів. Рекомендуємо оновлювати пароль до закінчення терміну дії в 30 днів.

Секретність посилання для Callback

Не залишайте посилання для Callback у відкритому доступі на вашому ресурсі.

Сторінка успішної оплати не гарантія успіху оплати

Не використовуйте факт переходу платника на сторінку успіщної оплати як признак успішної оплати. Статус транзакції та деталі оплати необхідно отримати тільки в Callback або в особистому кабінеті PSP Platon.

Звірка даних в Callback

При отриманні від нас Callback про успішну оплату рекомендуємо проводити на вашому боці додаткову перевірку суми та ордера з Callback на відповідність первоначальної суми та ордера у вашій базі даних, які були вказані при створенні замовлення.

Синхронний режим

Стандартний режим. Передавати async = N не потрібно.

Асинхронний режим

Цей режим активується при передачі async = Y. В цьому режимі обов'язково необхідно використовувати callback.

При оплаті без 3DS СИНХРОННИЙ РЕЖИМ

При успішній оплаті без 3DS СИНХРОННИЙ РЕЖИМ

Response при успішному списанні без 3DS

{
  "action":"SALE",
  "result":"SUCCESS",
  "status":"SETTLED",
  "order_id":"ORDER-12345",
  "trans_id":"03346-89217- 70541",
  "descriptor":"test",
  "trans_date":"2012-04-03 16:02:01"
}

Параметри	Опис
`action` ОБОВ'ЯЗКОВИЙ	`SALE`
`result` ОБОВ'ЯЗКОВИЙ	`SUCCESS`
`status` ОБОВ'ЯЗКОВИЙ	`SETTLED` `PENDING` якщо оплата в холді
`order_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в системі мерчанта
`trans_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в платіжній системі
`trans_date` ОБОВ'ЯЗКОВИЙ	Дата транзакції. Час в UTC
`descriptor` ОБОВ'ЯЗКОВИЙ	Опис
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` ОПЦІЯ	10 додаткових полів

Callback при успішному списанні

array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'SETTLED',
  'order_id' => '1_691201',
  'trans_id' => '31176-65336-00444',
  'trans_date' => '2021-01-27 16:55:33',
  'descriptor' => NULL,
  'auth_code' => '990647',
  'hash' => '********************************',
)

Параметри	Опис
`action` ОБОВ'ЯЗКОВИЙ	`SALE`
`result` ОБОВ'ЯЗКОВИЙ	`SUCCESS`
`status` ОБОВ'ЯЗКОВИЙ	`SETTLED` `PENDING` якщо оплата в холді
`order_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в системі мерчанта
`trans_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в платіжній системі
`trans_date` ОБОВ'ЯЗКОВИЙ	Дата транзакції. Час в UTC
`descriptor` ОБОВ'ЯЗКОВИЙ	Опис
`auth_code` ОБОВ'ЯЗКОВИЙ	Код авторизації
`amount` ОПЦІЯ	Сума
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` ОПЦІЯ	10 додаткових полів
`MID` ОПЦІЯ	Унікальний ідентифікатор термінала в платіжній системі.
`card` ОПЦІЯ	Маска картки в форматі ХХХХХХ****ХХХХ
`card_hash` ОПЦІЯ	Унікальне зашифроване значення номера картки, яке повертатиметься в колбеку під час оплати, верифікації, погашення та виплати коштів на картку. Цей параметр дозволить вам в вашій системі: Прив'язати картку до клієнта. Перевірити, чи не використовував інший клієнт цю ж картку. Перевірити, які кредити, товари та послуги погашаються цією карткою. Відстежувати шахрайство, коли клієнт використовує ту ж картку з іншого облікового запису, наприклад, щоб знову скористатися акцією.
`brand` ОПЦІЯ	`'brand' => 'VISA'` `'brand' => 'MASTER'` `'brand" => 'PROSTIR'`
`fee_type` ОПЦІЯ	Ознака як буде списуватись комісія з мерчанта: `ACT` - по актам. `TRANSACTION` - потранзакційно.
`fee` ОПЦІЯ	Сума комісії з мерчанта в ГРН
`currency` ОПЦІЯ	Валюта
`hash` ОБОВ'ЯЗКОВИЙ	Зашифрований підписк для перевірки достовірності коллбека md5( strtoupper( strrev(email). client_pass. trans_id. strrev( substr(card,0,6). substr(card,-4) ) ) ) Увага! Якщо в запиті на оплату не було вказано `email`, то при перевірці `hash` вкажіть пусте значення `email`.

При невдалій оплаті без 3DS СИНХРОННИЙ РЕЖИМ

Response при невдалому списанні без 3DS

{
  "action":"SALE",
  "result":"DECLINED",
  "status":"DECLINED",
  "order_id":"ORDER-12345",
  "trans_id":"03346- 89214-54141",
  "trans_date":"2012-04-03 16:02:01",
  "decline_reason":"Declined by processing"
}

Параметри	Опис
`action` ОБОВ'ЯЗКОВИЙ	`SALE`
`result` ОБОВ'ЯЗКОВИЙ	`DECLINED`
`status` ОБОВ'ЯЗКОВИЙ	ID транзакції в системі мерчанта
`order_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в платіжній системі
`trans_id` ОБОВ'ЯЗКОВИЙ	Дата транзакції. Час в UTC
`trans_date` ОБОВ'ЯЗКОВИЙ	Опис
`decline_reason` ОБОВ'ЯЗКОВИЙ	Причина відмови

Callback при невдалому списанні

array (
  'action' => 'SALE',
  'result' => 'DECLINED',
  'status' => 'DECLINED',
  'order_id' => '1_691201',
  'trans_id' => '31176-65336-00444',
  'trans_date' => '2021-01-27 16:55:33',
  'decline_reason' => 'Declined by processing',
  'hash' => '********************************',
)

Параметри	Опис
`action` ОБОВ'ЯЗКОВИЙ	`SALE`
`result` ОБОВ'ЯЗКОВИЙ	`DECLINED`
`status` ОБОВ'ЯЗКОВИЙ	`DECLINED`
`order_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в системі мерчанта
`trans_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в платіжній системі
`trans_date` ОБОВ'ЯЗКОВИЙ	Дата транзакції. Час в UTC
`amount` ОПЦІЯ	Сума
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` ОПЦІЯ	10 додаткових полів
`MID` ОПЦІЯ	Унікальний ідентифікатор термінала в платіжній системі.
`card` ОПЦІЯ	Маска картки в форматі ХХХХХХ****ХХХХ
`card_hash` ОПЦІЯ	Унікальне зашифроване значення номера картки, яке повертатиметься в колбеку під час оплати, верифікації, погашення та виплати коштів на картку. Цей параметр дозволить вам в вашій системі: Прив'язати картку до клієнта. Перевірити, чи не використовував інший клієнт цю ж картку. Перевірити, які кредити, товари та послуги погашаються цією карткою. Відстежувати шахрайство, коли клієнт використовує ту ж картку з іншого облікового запису, наприклад, щоб знову скористатися акцією.
`brand` ОПЦІЯ	`'brand' => 'VISA'` `'brand' => 'MASTER'` `'brand" => 'PROSTIR'`
`fee_type` ОПЦІЯ	Ознака як буде списуватись комісія з мерчанта: `ACT` - по актам. `TRANSACTION` - потранзакційно.
`fee` ОПЦІЯ	Сума комісії з мерчанта в ГРН
`currency` ОПЦІЯ	Валюта
`decline_reason` ОБОВ'ЯЗКОВИЙ	Причина відмови в оплаті
`hash` ОБОВ'ЯЗКОВИЙ	Зашифрований підписк для перевірки достовірності коллбека md5( strtoupper( strrev(email). client_pass. trans_id. strrev( substr(card,0,6). substr(card,-4) ) ) ) Увага! Якщо в запиті на оплату не було вказано `email`, то при перевірці `hash` вкажіть пусте значення `email`.Зашифрованная подпись для проверки достоверности коллбека

При оплаті без 3DS АСИНХРОННИЙ РЕЖИМ

Проміжна відповідь АСИНХРОННИЙ РЕЖИМ

Response при успішній відправці запиту на обробку

{
  "action":"SALE",
  "result":"ACCEPTED",
  "trans_id":"03346-89211- 86461",
  "order_id":"ORDER-12345",
  "trans_date":"2012-04-03 16:02:01"
}

Параметри	Опис
`action` ОБОВ'ЯЗКОВИЙ	`SALE`
`result` ОБОВ'ЯЗКОВИЙ	`ACCEPTED`
`order_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в системі мерчанта
`trans_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в платіжній системі
`trans_date` ОБОВ'ЯЗКОВИЙ	Дата транзакції. Час в UTC

При успішній оплаті з 3DS АСИНХРОННИЙ РЕЖИМ

Callback при успішному списанні

array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'SETTLED',
  'order_id' => '4385323',
  'trans_id' => '28261-47789-28578',
  'trans_date' => '2020-02-25 07:12:58',
  'descriptor' => NULL,
  'recurring_token' => '01e00c2b39bb3b933723307c442efd02',
  'card_token' => '8ef3111ac1093f6ccb817acef7f0845601d0994689a5f57949f94b0d086c7fe2',
  'hash' => '********************************',
)

Параметри	Опис
`action` ОБОВ'ЯЗКОВИЙ	`SALE`
`result` ОБОВ'ЯЗКОВИЙ	`SUCCESS`
`status` ОБОВ'ЯЗКОВИЙ	`SETTLED` `PENDING` якщо оплата в холді
`order_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в системі мерчанта
`trans_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в платіжній системі
`trans_date` ОБОВ'ЯЗКОВИЙ	Дата транзакції. Час в UTC
`descriptor` ОБОВ'ЯЗКОВИЙ	Опис
`auth_code` ОБОВ'ЯЗКОВИЙ	Код авторизації
`amount` ОПЦІЯ	Сума
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` ОПЦІЯ	10 додаткових полів
`MID` ОПЦІЯ	Унікальний ідентифікатор термінала в платіжній системі.
`card` ОПЦІЯ	Маска картки в форматі ХХХХХХ****ХХХХ
`card_hash` ОПЦІЯ	Унікальне зашифроване значення номера картки, яке повертатиметься в колбеку під час оплати, верифікації, погашення та виплати коштів на картку. Цей параметр дозволить вам в вашій системі: Прив'язати картку до клієнта. Перевірити, чи не використовував інший клієнт цю ж картку. Перевірити, які кредити, товари та послуги погашаються цією карткою. Відстежувати шахрайство, коли клієнт використовує ту ж картку з іншого облікового запису, наприклад, щоб знову скористатися акцією.
`brand` ОПЦІЯ	`'brand' => 'VISA'` `'brand' => 'MASTER'` `'brand" => 'PROSTIR'`
`fee_type` ОПЦІЯ	Ознака як буде списуватись комісія з мерчанта: `ACT` - по актам. `TRANSACTION` - потранзакційно.
`fee` ОПЦІЯ	Сума комісії з мерчанта в ГРН
`currency` ОПЦІЯ	Валюта
`hash` ОБОВ'ЯЗКОВИЙ	Зашифрований підписк для перевірки достовірності коллбека md5( strtoupper( strrev(email). client_pass. trans_id. strrev( substr(card,0,6). substr(card,-4) ) ) ) Увага! Якщо в запиті на оплату не було вказано `email`, то при перевірці `hash` вкажіть пусте значення `email`.

При невдалій оплаті з 3DS АСИНХРОННИЙ РЕЖИМ

Callback при невдалому списанні

array (
  'action' => 'SALE',
  'result' => 'DECLINED',
  'status' => 'DECLINED',
  'order_id' => '4092002',
  'trans_id' => '28076-29879-99538',
  'trans_date' => '2020-02-03 20:49:47',
  'decline_reason' => 'Declined by processing',
  'hash' => '********************************',
)

Параметри	Опис
`action` ОБОВ'ЯЗКОВИЙ	`SALE`
`result` ОБОВ'ЯЗКОВИЙ	`DECLINED`
`status` ОБОВ'ЯЗКОВИЙ	`DECLINED`
`order_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в системі мерчанта
`trans_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в платіжній системі
`trans_date` ОБОВ'ЯЗКОВИЙ	Дата транзакції. Час в UTC
`amount` ОПЦІЯ	Сума
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` ОПЦІЯ	10 додаткових полів
`MID` ОПЦІЯ	Унікальний ідентифікатор термінала в платіжній системі.
`card` ОПЦІЯ	Маска картки в форматі ХХХХХХ****ХХХХ
`card_hash` ОПЦІЯ	Унікальне зашифроване значення номера картки, яке повертатиметься в колбеку під час оплати, верифікації, погашення та виплати коштів на картку. Цей параметр дозволить вам в вашій системі: Прив'язати картку до клієнта. Перевірити, чи не використовував інший клієнт цю ж картку. Перевірити, які кредити, товари та послуги погашаються цією карткою. Відстежувати шахрайство, коли клієнт використовує ту ж картку з іншого облікового запису, наприклад, щоб знову скористатися акцією.
`brand` ОПЦІЯ	`'brand' => 'VISA'` `'brand' => 'MASTER'` `'brand" => 'PROSTIR'`
`fee_type` ОПЦІЯ	Ознака як буде списуватись комісія з мерчанта: `ACT` - по актам. `TRANSACTION` - потранзакційно.
`fee` ОПЦІЯ	Сума комісії з мерчанта в ГРН
`currency` ОПЦІЯ	Валюта
`decline_reason` ОБОВ'ЯЗКОВИЙ	Причина відмови в оплаті
`hash` ОБОВ'ЯЗКОВИЙ	Зашифрований підписк для перевірки достовірності коллбека md5( strtoupper( strrev(email). client_pass. trans_id. strrev( substr(card,0,6). substr(card,-4) ) ) ) Увага! Якщо в запиті на оплату не було вказано `email`, то при перевірці `hash` вкажіть пусте значення `email`.Зашифрованная подпись для проверки достоверности коллбека

При помилці в запиті

Response при помилці в запиті

{
  "result":"ERROR",
  "error_message":"Error description"
}

Протерміновані токени

Якщо у відповіді на запит ви отримали одну з вказаних нижче помилок, вам необхідно видалити цей протермінований токен:

{"result":"ERROR","error_message":"Invalid card_exp_month, card_exp_year"}
{"result":"ERROR","error_message":"Invalid card_exp_month"}
{"result":"ERROR","error_message":"Initial transaction too old"}

Ці card_token заблоковані та не підлягають відновленню по причині блокування / закінчення терміну дії картки.

Необхідно отримати новий card_token провівши нову оплату чи верифікацію.

Помилки запитів

Список помилок та рішень

Incorrect sign

Response: {"result":"ERROR","error_message":"Incorrect sign"}

Вариант 1

Неверно сформирована зашифрованная подпись.

Проверьте верность сформированной подписи. Если ошибку не нашли обратитесь в тех поддержку.

Вариант 2

Добавлены параметры, которые не входят в данный запрос.

Проверьте список передаваемых параметров. Если ошибку не нашли обратитесь в тех поддержку.

Вариант 3

Неверно зашифрована data.

Проверить используете ли вы UTF-8 и верный формат параметров.

Empty action

Response: {"result":"ERROR","error_message":"Empty action"}

Вариант 1

Параметр action заполнен не верно, пуст, или не на первом месте в списке параметров запроса.

Проверьте список передаваемых параметров. Если ошибку не нашли обратитесь в тех поддержку.

Вариант 2

Запрос отправляется методом GET, а не POST.

Отправить запрос методом POST.

Order already exists

Response: {"result":"ERROR","error_message":"Order already exists"}

Значение order_id должно быть уникальным. Данная ошибка говорит о том, что у вас уже была успешная транзакция с таким order_id.

Заменить значение order_id на новое уникальное.

Service error

Response: {"result":"ERROR","error_message":"Service error"}

Ситуация требует внимания сотрудников Platon.

Рекомендуем обратиться в тех саппорт Platon для проверки причины.

Previous transaction not completed

Response: {"result":"ERROR","error_message":"Previous transaction not completed"}

Ситуация требует внимания сотрудников Platon.

Рекомендуем обратиться в тех саппорт Platon для проверки причины.

Recurring not supported

Response: {"result":"ERROR","error_message":"Recurring not supported"}

rc_token заблокирован, подробнее о причинах можно узнать в разделе /wiki/spaces/docs/pages/1323303006

Рекомендуем удалить данный rc_token из вашей базы данных и повторить верификацию карты для получения rc_token и возможности проведения транзакций по новому токену.

Initial transaction too old

Response: {"result":"ERROR","error_message":"Initial transaction too old"}

card_token заблокирован, подробнее о причинах можно узнать в разделе /wiki/spaces/docs/pages/1323303006

Рекомендуем удалить данный card_token из вашей базы данных и повторить верификацию карты для получения card_token и возможности проведения транзакций по новому токену.

Account error

Response: {"result":"ERROR","error_message":"Account error"}

Вариант 1

Ваш IP адрес не добавлен в наш белый список.

Обратитесь в тех поддержку для добавления вашего IP в белый список.

Вариант 2

Данный функционал вам не подключен.

Обратитесь в тех поддержку для активации функционала.

Вариант 3

Запрос отправлен не на нужную ссылку.

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

Вариант 4

В запросе указан неверное или несуществующее значение параметра channel_id.

Проверьте передаваемое значение channel_id на достоверность или уточните у тех поддержки доступные у вас значение.

Card token not found for current client

Response: {"result":"ERROR","error_message":"Card token not found for current client"}

Отправка запроса по этому card_token отключена для данного API ключа так как card_token был получен на другом API ключе.

Обратитесь в тех поддержку для решения данной ситуации.

Incorrect hash

Response: {"result":"ERROR","error_message":"Incorrect hash"}

Вариант 1

Неверно сформирована зашифрованная подпись.

Проверьте верность сформированной подписи. Если ошибка не найдена обратитесь в тех поддержку.

Вариант 2

Добавлены параметры, которые не входят в данный запрос.

Проверьте список передаваемых параметров. Если ошибка не найдена обратитесь в тех поддержку.

Вариант 3

Запрос был отправлен не с того API ключа по которому был получен rc_token.

Рекомендуем заменить API ключ на тот, по которому был получен rc_token.

Duplicate request

Response: {"result":"ERROR","error_message":"Duplicate request"}

За одну минуту в систему вами было отправлено несколько одинаковых запросов.

Рекомендуем проверить ваш механизм отправки запросов на наличие задвоения.

Incorrect card_token value

Response: {"result":"ERROR","error_message":"Incorrect card_token value"}

Вариант 1

Запрос был отправлен менее чем через 10 минут после получения токена.

Рекомендуем настроить отправку запросов минимум через 10 минут после получения токена. Запрос по которому получена эта ошибка необходимо повторить.

Вариант 2

В параметр card_token внесено неверное значение.

Рекомендуем проверить верность внесенных данных в поле card_token полученного из коллбека ранее. Запрос по которому получена эта ошибка необходимо повторить.

Not found card token

Response: {"result":"ERROR","error_message":"Not found card token"}

Вариант 1

Запрос был отправлен менее чем через 10 минут после получения токена.

Рекомендуем настроить отправку запросов минимум через 10 минут после получения токена. Запрос по которому получена эта ошибка необходимо повторить.

Вариант 2

В параметр card_token внесено неверное значение.

Рекомендуем проверить верность внесенных данных в поле card_token полученного из коллбека ранее. Запрос по которому получена эта ошибка необходимо повторить.

102: Token is not active

'decline_reason' => '102: Token is not active'

rc_token заблокирован, подробнее о причинах можно узнать в разделе /wiki/spaces/docs/pages/1323303006

Рекомендуем удалить данный rc_token из вашей базы данных и повторить верификацию карты для получения rc_token и возможности проведения транзакций по новому токену.

Wrong credit_date

'error_message' => 'Wrong credit_date'

credit_date введен не согласно формата YYYY-MM-DD или указана будущая дата.

Рекомендуем указать в credit_date прошедшую дату или текущую.

Invalid pan

'error_message' => 'Invalid pan'

Invalid pan введен не верный номер карты.

Сверьте номер карты. Рекомендуем проверять номер карты на действительность перед отправкой в запросе используя алгоритм Луна.

IA регулярний платіж по токену

Зміст

Опис

Вимоги

PSP Platon

Visa

Mastercard

Простір

Оплата частинами Monobank

Оплата частинами ПриватБанк

PCI DSS

Apple Pay

Google Pay

Privat24

API параметри

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

Тестування

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

Callback & Response

Telegram Bot

Особистий кабінет PSP Platon

Інструкція по використанню

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

CSV файл

Банківський реєстр

API запит статуса

Callback

URL для Callback

IP адреси

Очікувана відповідь на Callback

Помилки при відправці Callback

Перевідправка Callback

Довірені IP

Секретність API доступів

Секретність кабінету

Секретність посилання для Callback

Сторінка успішної оплати не гарантія успіху оплати

Звірка даних в Callback

Синхронний режим

Асинхронний режим

При оплаті без 3DS СИНХРОННИЙ РЕЖИМ

При успішній оплаті без 3DS СИНХРОННИЙ РЕЖИМ

При невдалій оплаті без 3DS СИНХРОННИЙ РЕЖИМ

При оплаті без 3DS АСИНХРОННИЙ РЕЖИМ

Проміжна відповідь АСИНХРОННИЙ РЕЖИМ

При успішній оплаті з 3DS АСИНХРОННИЙ РЕЖИМ

При невдалій оплаті з 3DS АСИНХРОННИЙ РЕЖИМ

При помилці в запиті

Протерміновані токени

Помилки запитів

Вариант 1

Вариант 2

Вариант 3

Вариант 1

Вариант 2

Вариант 1

Вариант 2

Вариант 3

Вариант 4

Вариант 1

Вариант 2

Вариант 3

Вариант 1

Вариант 2

Вариант 1

Вариант 2