- Created by Tech Platon on Sept 25, 2024
You are viewing an old version of this content. View the current version.
Compare with Current View Version History
Version 1 Next »
Зміст
Опис
Цей метод дозволяє відправити кошти на картку при наявності у вас повного номеру картки клієнта.
Увага! Цей запит на виплату в цілях безпеки використовує перевірку унікальності по order_id для виключення випадків дублів запитів на видачу. У випадку відправки мерчантом декількох однакових запитів з різницею в часі від меньше 1 сек до 10 хв (що не дозволить системі за такий термін провести перевірку на унікальність) - PSP Platon не бере на себе відповідальність за відшкодування лишніх виданих коштів.
Чекліст інтеграції
- Провести інтеграцію API методу.
- Надати тех підтримці PSP Platon посилання для Callback.
- Повідомити тех підтримці PSP Platon ваші IP адреса серверів для додавання в білий список.
- Провести виплату використовуючи тестові реквізити / реальну картку (активується після підписання договору).
- Отримати Callback та / або Response.
Вимоги
Необхідна підтримка протоколу TLS не нижче версії 1.2
API параметри
HTTP METHOD: POST
API ENDPOINT: https://secure.platononline.com/a2a/
Параметр | Значення | Опис | Особливості |
|
| Код платіжного метода | |
| String | API ключ мерчанта | Ключ надається на пошту мерчанту |
| String | Унікальний ордера мерчанта | Max 255 символів |
| Number | Сума виплати | Вірний варіант 1000.00 Невалідні варіанти 1000 |
|
| Валюта | Виплата можлива лише в національній валюті гривні. |
| String | Опис | Max 1024 символа |
| Number | Повний номер рахунку відправника | 16 символів |
| Number | Повний номер рахунку отримувача | 16 символів |
| String | Ім'я відправника | |
| String | Прізвище отримувача | |
| String | Телефон відправника | Max 32 символи |
| String | Валідний емейл відправника | Max 128 символів |
| String | Контрольний підпис | md5(
strtoupper(
$pass.
$orderId
)
)
|
| String | ІПН відпраника | |
| String | Додатковий платіжний канал | Дозволяє використати інший банківський термінал |
|
| Створення токену |
Приклад запиту
<?php
$url = 'https://secure.platononline.com/a2a/';
$key = '***';
$pass = '********';
$orderId = Date('Ym-dH-is');
$data = [
'client_key' => $key,
'action' => 'ACCOUNT2ACCOUNT',
'order_id' => $orderId,
'order_amount' => '1.00',
'order_currency' => 'UAH',
'order_description' => 'TEST ACCOUNT TRANSACTION',
'sender_account_number' => '11111111111111111111',
'recipient_account_number' => '22222222222222222222',
'sender_first_name' => 'Kostiantyn',
'sender_last_name' => 'Korolev',
'phone' => '0509102155',
'email' => 'test@gmail.com',
'sender_taxn' => '333333',
'channel_id' => '',
'req_token' => 'N',
'ext1' => 'ext1',
'ext2' => 'ext2',
'ext3' => 'ext3',
'ext4' => 'ext4',
'ext5' => 'ext5',
'ext6' => 'ext6',
'ext7' => 'ext7',
'ext8' => 'ext8',
'ext9' => 'ext9',
'ext10' => 'ext10',
'hash' => md5(strtoupper($pass.$orderId)),
];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$response = curl_exec($ch);
if (curl_errno($ch)) {
$error[] = 'CURL ErrorNo: ' . curl_errno($ch);
$error[] = 'CURL Error: ' . curl_error($ch);
$error[] = 'Url: ' . $url;
$error[] = 'Data: ' . $data;
echo print_r($error, true);
}
curl_close($ch);
print_r($response);
Тестування
Номер картки
4111 1111 1111 1111
Місяць / Рік
Тестові кейси:
Для успішної оплати використайте термін дії:
01 / 2026
Для не успішної оплати використайте термін дії:
02 / 2026
CVV2
Будь які три цифри.
Перевірка виплати
Callback & Response
Використовуйте Callback або Response (в залежності від типу запиту) для автоматизації процесу зарахування у вашій системі.
Відправляється автоматично або за вашим API запитом для перевідправки.
Telegram Bot
Нотифікація в Telegram Bot про успішну оплату та деталізація одразу після списання (підключення бота по домовленості в груповому чаті з мерчантом)
Особистий кабінет PSP Platon
Всю необхідну інформацію ви знайдете в нашому особистому кабінеті за посиланням https://secure.platononline.net/auth/login
Інструкція по використанню
Інструкція до особистого кабінету PSP Platon
Помилки доступу в кабінет
Пароль для особистого кабінета актуальний 30 днів. В налаштуваннях кабінету є можливість змінити пароль до кінця терміну його дії, а також нотифікація в останні 10 днів перед закінченням терміну дії старого паролю.
Якщо пароль було втрачено або протерміновано і доступ в кабінет заблоковано, будь ласка, зверніться в груповий чат вказавши логін та email для відправки нового пароля.
CSV файл
CSV файл з деталями оплати можна завантажити в особистому кабінеті PSP Platon.
Для коректного відображення даних в Microsoft Excel рекомендуємо ознайомитись з інструкцією по використанню CSV файлів.
Банківський реєстр
Банківські реєстри можуть бути відправлені вам на регулярній основі на ваш Email або FTP.
API запит статуса
Callback та Response
URL для Callback
Для отримання Callback відправте URL на ваш обробник в груповий чат з вказанням API ключа для якого потрібно прописати посилання. Посилання для Callback вказується на боці PSP Platon.
Очікувана відповідь на Callback
Після відправки Callback у відповідь PSP Platon має отримати HTTP код 200.
Помилки при відправці Callback
Якщо Callback не вдалося відправити або було отримано не HTTP код 200, будуть проведені додаткові повторні спроби відправки в проміжках часу 1 хв, 5 хв, 10 хв, 15 хв, 30 хв, 60 хв.
Перевідправка Callback
Для перевідправки Callback прохання повідомити в груповий чат список необхідних ордерів.
Увага! Рекомендації цього розділу допоможуть забезпечити безпеку від шахрайських дій пов'язаних з вашим сайтом та транзакціями.
Секретність API доступів
Не тримайте у відкритому доступі API ключ та API пароль, а також не надавайте обидва ці параметри в групові робочі чати, в тому числі з нами. Для перевірки деталей представники PSP Platon можуть попросити у вас лише API ключ, пароль треба тримати в таємниці.
Секретність кабінету
Не розголошуйте логін та пароль від вашого особистого кабінету третім особам. У випадку якщо доступ був втрачений зверніться в груповий чат. Пароль від особистого кабінету діє 30 днів. Рекомендуємо оновлювати пароль до закінчення терміну дії в 30 днів.
Секретність посилання для Callback
Не залишайте посилання для Callback у відкритому доступі на вашому ресурсі.
Сторінка успішної оплати не гарантія успіху оплати
Не використовуйте факт переходу платника на сторінку успішної оплати як признак успішної оплати. Статус транзакції та деталі оплати необхідно отримати тільки в Callback або в особистому кабінеті PSP Platon.
Звірка даних в Callback
При отриманні від нас Callback про успішну оплату рекомендуємо проводити на вашому боці додаткову перевірку суми та ордера з Callback на відповідність початкової суми та ордера у вашій базі даних, які були вказані при створенні замовлення.
При успішній виплаті:
array ( 'action' => 'CREDIT2CARD', 'result' => 'SUCCESS', 'status' => 'SETTLED', 'order_id' => '1328876', 'trans_id' => '27894-89059-67608', 'trans_date' => '2020-01-13 20:55:05', 'hash' => '********************************', 'card_hash' => 'cc1c30cfbfe57b068b1f6c4c336791282256b2efc8cf52e85cc2e5fa2a62047a', 'fee_type' => 'TRANSACTION', 'fee' => '0.5', )
Для проверки достоверности полученного callback, рекомендуем сверять подпись hash по формуле md5(strtoupper(client_pass.trans_id.strrev(substr(card_number,0,6).substr(card_number,-4))))
Параметр | Описание |
|---|---|
|
|
|
|
|
|
| Уникальный ордер ID транзакции в системе мерчанта |
| Уникальный ордер ID транзакции в системе Platon |
| Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS) |
| Зашифрованный токен карты для последующих транзакций по |
| Уникальное зашифрованное значение номера карты, которое будет возвращаться в коллбеке при оплате, верификации, погашении и выплате средств на карту. Этот параметр даст вам возможность в вашей системе:
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения. |
| Признак каким образом взимается комиссия:
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения. |
| Сумма комиссии с мерчанта по транзакции в ГРН Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения. |
| Зашифрованная проверочная подпись |
{
"action":"CREDIT2CARD",
"result":"SUCCESS",
"status":"SETTLED",
"order_id":"1328876",
"trans_id":"27894-89059-67608",
"trans_date":"2020-01-13 20:55:05"
}
При невдалій виплаті:
array ( 'action' => 'CREDIT2CARD', 'result' => 'DECLINED', 'status' => 'DECLINED', 'order_id' => '560404', 'trans_id' => '27894-80158-07868', 'trans_date' => '2020-01-13 20:40:15', 'decline_reason' => '9858: Restricted Card', 'hash' => '********************************', 'card_hash' => '31c9ea919afdc5361ca31cc9e3c4874af6bdd374601e7ef8e6c72b3d9ef0933f', )
Для проверки достоверности полученного callback, рекомендуем сверять подпись hash по формуле md5(strtoupper(client_pass.trans_id.strrev(substr(card_number,0,6).substr(card_number,-4))))
Параметр | Описание |
|---|---|
|
|
|
|
|
|
| Уникальный ордер ID транзакции в системе мерчанта |
| Уникальный ордер ID транзакции в системе Platon |
| Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS) |
| Зашифрованный токен карты для последующих транзакций по |
| Причина отмены транзакции |
| Зашифрованная проверочная подпись |
{
"action":"CREDIT2CARD",
"result":"DECLINED",
"status":"DECLINED",
"order_id":"560404",
"trans_id":"27894-80158-07868",
"trans_date":"2020-01-13 20:40:15",
"decline_reason":"9858: Restricted Card"
}
Проміжна відповідь у випадку технічних негараздів:
При отриманні Callback з таким статусом необхідно очікувати Callback з фінальним статусом транзакції.
Симулювати такий Callback в тестовому середовищі неможливо.
array ( 'action' => 'CREDIT2CARDTOKEN', 'result' => 'SUCCESS', 'status' => 'WAITING', 'order_id' => '5774734', 'trans_id' => '28262-75863-96848', 'trans_date' => '2020-02-25 10:46:26', 'hash' => '********************************', )
Для проверки достоверности полученного callback, рекомендуем сверять подпись hash по формуле md5(strtoupper(client_pass.trans_id.strrev(substr(card_number,0,6).substr(card_number,-4))))
Параметр | Описание |
|---|---|
|
|
|
|
|
|
| Уникальный ордер ID транзакции в системе мерчанта |
| Уникальный ордер ID транзакции в системе Platon |
| Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS) |
| Зашифрованный токен карты для последующих транзакций по |
| Зашифрованная проверочная подпись |
При отриманні Response з таким статусом необхідно очікувати Response з фінальним статусом транзакції.
Симулювати такий Response в тестовому середовищі неможливо.
{
"action":"CREDIT2CARDTOKEN",
"result":"SUCCESS",
"status":"WAITING",
"order_id":"5774734",
"trans_id":"28262-75863-96848",
"trans_date":"2020-02-25 10:46:26"
}
Помилки при виплатах
Bad response forwarded status (502)
Відмова банку-еквайєра без уточнення причин.
Зверніться до Platon Support для перевірки причин відмови виплати.
order_id_duplicate: Duplicate order_id
Відмова банку-еквайєра без уточнення причин.
Зверніться до Platon Support для перевірки причин відмови виплати.
Bad response forwarded status (502)
Сервер банку-еквайєра не відповідає
Зверніться до Platon Support для перевірки статусу виплати
Bad response forwarded status (504)
Сервер банку-еквайєра не відповідає
Зверніться до Platon Support для перевірки статусу виплати
9853: Invalid PIN
Відмова банку-емітента. Клієнт неправильно вказав реквізити картки
Клієнту необхідно вказати вірні реквізити картки
Final transaction status data not received from acquirer - wait time exceeded
Процесинг тимчасово недоступний. Транзакція в обробці
Зверніться до Platon Support для перевірки статусу виплати
9 9 Transaction is in processing…
Процесинг тимчасово недоступний. Транзакція в обробці
Зверніться до Platon Support для перевірки статусу виплати
2 11 Invalid signature (Invalid Signature)
Процесинг тимчасово недоступний. Транзакція в обробці
Зверніться до Platon Support для перевірки статусу виплати
3 90 General error during processing (General error during processing)
Процесинг тимчасово недоступний. Транзакція в обробці
Зверніться до Platon Support для перевірки статусу виплати
801: Original transaction not found
Процесинг тимчасово недоступний. Транзакція в обробці
Зверніться до Platon Support для перевірки статусу виплати
api_err: Service pl_check unavailable
Процесинг тимчасово недоступний. Транзакція в обробці
Зверніться до Platon Support для перевірки статусу виплати
Errors in curl working (7): Failed to connect to 172.16.109.8 port 443: Connection timed out (172.16.109.8)
Процесинг тимчасово недоступний. Транзакція в обробці
Зверніться до Platon Support для перевірки статусу виплати
err_service: Сервіс недоступний, спробуйте пізніше
Процесинг тимчасово недоступний. Транзакція в обробці
Зверніться до Platon Support для перевірки статусу виплати
err_payment_create: Failed to create payment
Відмова банку-еквайєра без уточнення причини
Зверніться до Platon Support для перевірки статусу виплати
4: Unknown error code
Відмова банку-еквайєра без уточнення причини
Зверніться до Platon Support для перевірки статусу виплати
9874: Format error
Відмова банку-еквайєра без уточнення причини
Зверніться до Platon Support для перевірки статусу виплати
payment_not_found: Платіж не знайдено
Відмова банку-еквайєра без уточнення причини
Зверніться до Platon Support для перевірки статусу виплати
9852: Invalid card
Відмова банку-емітента. Картка заблокована
Клієнту необхідно використовувати іншу активну картку
2 9852 Invalid card
Відмова банку-емітента. Картка заблокована
Клієнту необхідно використовувати іншу активну картку
9850: Unauthorized usage
Відмова банку-емітента. Картка заблокована
Клієнту необхідно використовувати іншу активну картку
9851: Expired card
Відмова банку-емітента. Термін дії картки закінчився
Клієнту необхідно використовувати іншу активну картку
2 9851 Expired card
Відмова банку-емітента. Термін дії картки закінчився
Клієнту необхідно використовувати іншу активну картку
9858: Restricted Card
Відмова банку-емітента. Карта заблокована за підозрою у шахрайстві
Клієнту необхідно використовувати іншу активну картку
2 9858 Restricted Card
Відмова банку-емітента. Карта заблокована за підозрою у шахрайстві
Клієнту необхідно використовувати іншу активну картку
9875: External decline special condition
Відмова банку-емітента. Карта заблокована за підозрою у шахрайстві
Клієнту необхідно використовувати іншу активну картку
2 9875 External decline special condition
Відмова банку-емітента. Карта заблокована за підозрою у шахрайстві
Клієнту необхідно використовувати іншу активну картку
9859: Insufficient funds
Відмова банку-емітента. На карті клієнта від'ємний баланс
Клієнту необхідно погасити заборгованість за карткою. Після цього можна повторити виплату
2 9859 Insufficient funds
Відмова банку-емітента. На карті клієнта від'ємний баланс
Клієнту необхідно погасити заборгованість за карткою. Після цього можна повторити виплату
9863: Withdrawal limit already reached
Відмова банку-емітента. Перевищено ліміт суми зарахування коштів
Клієнту необхідно звернутися до свого банку
2 9863 Withdrawal limit already reached
Відмова банку-емітента. Перевищено ліміт суми зарахування коштів
Клієнту необхідно звернутися до свого банку
9864: Credit amount limit
Відмова банку-емітента. Перевищено ліміт суми зарахування коштів
Клієнту необхідно звернутися до свого банку
2 9864 Credit amount limit
Відмова банку-емітента. Перевищено ліміт суми зарахування коштів
Клієнту необхідно звернутися до свого банку
9867: Invalid amount
Відмова банку-емітента. Перевищено ліміт суми зарахування коштів
Клієнту необхідно звернутися до свого банку
2 9867 Invalid amount
Відмова банку-емітента. Перевищено ліміт суми зарахування коштів
Клієнту необхідно звернутися до свого банку
9871: Contact card issuer
Відмова банку-емітента. Емітент недоступний
Повторіть видачу за 15 хвилин
2 9871 Contact card issuer
Відмова банку-емітента. Емітент недоступний
Повторіть видачу за 15 хвилин
2900: Bin Block
Відмова банку-еквайєра. BIN карти заблоковано за вашою ініціативою
Клієнту необхідно використовувати іншу активну картку
2 2900 Bin Block
Відмова банку-еквайєра. BIN карти заблоковано за вашою ініціативою
Клієнту необхідно використовувати іншу активну картку
98: Merchant is blocked
Відмова банку-еквайєра. На транзитному рахунку недостатньо коштів на виплату. Термінал для виплати заблоковано
Поповніть транзитний рахунок та повторіть виплату
2 98 Merchant is blocked
Відмова банку-еквайєра. На транзитному рахунку недостатньо коштів на виплату. Термінал для виплати заблоковано
Поповніть транзитний рахунок та повторіть виплату
err_refund_balance: Not enough funds
Відмова банку-еквайєра. На транзитному рахунку недостатньо коштів на виплату. Термінал для виплати заблоковано
Поповніть транзитний рахунок та повторіть виплату
err_payment: Failed to make payment. Please make sure the parameters are entered correctly and try again
Відмова банку-еквайєра без уточнення причини
Зверніться до Platon Support для перевірки причин відмови виплати
9860: Uses limit exceeded
Відмова банку-емітента. Перевищено ліміт кількості операцій
Клієнту необхідно звернутися до свого банку
2 9860 Uses limit exceeded
Відмова банку-емітента. Перевищено ліміт кількості операцій
Клієнту необхідно звернутися до свого банку
9883: PIN tries limit was exceeded
Відмова банку-емітента. Перевищено ліміт кількості операцій
Клієнту необхідно звернутися до свого банку
2 9883 PIN tries limit was exceeded
Відмова банку-емітента. Перевищено ліміт кількості операцій
Клієнту необхідно звернутися до свого банку
9855: Ineligible transaction
Відмова банку-емітента. Перевищено ліміт кількості операцій
Клієнту необхідно звернутися до свого банку
9868: External decline
Відмова банку-емітента. Перевищено ліміт кількості операцій
Клієнту необхідно звернутися до свого банку
2 9868 External decline
Відмова банку-емітента. Перевищено ліміт кількості операцій
Клієнту необхідно звернутися до свого банку
9872: Destination not available
Відмова банку-емітента. Перевищено ліміт кількості операцій
Клієнту необхідно звернутися до свого банку
9855 Ineligible transaction
Відмова банку-емітента. Перевищено ліміт кількості операцій
Клієнту необхідно звернутися до свого банку
2 9855 Ineligible transaction
Відмова банку-емітента. Перевищено ліміт кількості операцій
Клієнту необхідно звернутися до свого банку
9857: Transaction not supported
Відмова банку-емітента. Перевищено ліміт кількості операцій
Клієнту необхідно звернутися до свого банку
2 9857 Transaction not supported
Відмова банку-емітента. Перевищено ліміт кількості операцій
Клієнту необхідно звернутися до свого банку
9854: System error
Відмова банку-емітента. Банк не підтвердив транзакцію
Клієнту необхідно звернутися до свого банку
2 9854 System error
Відмова банку-емітента. Банк не підтвердив транзакцію
Клієнту необхідно звернутися до свого банку
9882: Invalid transaction
Відмова банку-емітента. Виплата на валютну картку або картку monobank
Клієнту необхідно звернутися до свого банку
2 9882 Invalid transaction
Відмова банку-емітента. Виплата на валютну картку або картку monobank
Клієнту необхідно звернутися до свого банку
3914: Country not allowed
Відмова банку-емітента. Клієнт неправильно вказав реквізити картки
Клієнту необхідно вказати вірні реквізити картки
AMOUNT_TOO_BIG
Відмовлено PSP Platon. Перевищено ліміт на узгоджену раніше суму виплат
Зменшити суму виплати або звернеться до Platon Support
CREDIT_COUNT_CARD_24HOURS
Відмовлено PSP Platon. Перевищено ліміт узгодженої раніше кількості виплат
Провести виплату завтра або звернеться до Platon Support
CREDITS_AMOUNT_CARD_24H
Відмовлено PSP Platon. Перевищено ліміт узгодженої раніше кількості виплат
Провести виплату завтра або звернеться до Platon Support
limit: Limit is exceeded
Відмова банку-еквайєра без уточнення причини
Зверніться до Platon Support для перевірки причин відмови виплати
2 Transaction declined
Відмова банку-еквайєра без уточнення причини
Зверніться до Platon Support для перевірки причин відмови виплати
2903: Card daily limit reached
Відмова банку-еквайєра без уточнення причини
Зверніться до Platon Support для перевірки причин відмови виплати
2 2903 Card daily limit reached
Відмова банку-еквайєра без уточнення причини
Зверніться до Platon Support для перевірки причин відмови виплати
2916: Card country do not match IP country
Відмова банку-еквайєра без уточнення причини
Зверніться до Platon Support для перевірки причин відмови виплати
2 2916 Card country do not match IP country
Відмова банку-еквайєра без уточнення причини
Зверніться до Platon Support для перевірки причин відмови виплати
4: Unknown error code
Відмова банку-еквайєра без уточнення причини
Зверніться до Platon Support для перевірки причин відмови виплати
Test antifraud decline
Відмова PSP Platon без уточнення причин
Зверніться до Platon Support для перевірки причин відмови виплати
996 General merchant amount limit
Відмова банку-еквайєра. Перевищено ліміт на узгоджену раніше суму виплат протягом доби.
Повторити виплату після 00:00.
Missing response parameter: paymentDate
Відмова банку-еквайєра. Помилка сесії.
Повторити виплату за 15 хвилин.
115 Invalid recipient name
Відмова банку-еквайєра. Неправильно вказано ПІБ одержувача кредиту
Перевірити правильність заповнених даних
95: Amount over maximum
Відмова банку-еквайєра. Перевищено ліміт максимальної суми виплати на картку
Зменшіть суму виплати. Ліміти: для карток ПриватБанк – 1200 $ за курсом банку; інші банки – 14999 грн
9840: Lost card
Відмова банку-емітента. Карта загублена
Клієнту необхідно використовувати іншу активну картку
2 9840 Lost card
Відмова банку-емітента. Карта загублена
Клієнту необхідно використовувати іншу активну картку
9841: Stolen card
Відмова банку-емітента. Карта вкрадена
Клієнту необхідно використовувати іншу активну картку
2 9841: Stolen card
Відмова банку-емітента. Карта вкрадена
Клієнту необхідно використовувати іншу активну картку
9850: Unauthorized usage
Відмова банку-емітента. Карта заблокована
Клієнту необхідно використовувати іншу активну картку
2 9850 Unauthorized usage
Відмова банку-емітента. Карта заблокована
Клієнту необхідно використовувати іншу активну картку
902 PAYMENT_AUTH_FAILED: AuthCode 902
Відмова банку-емітента. Банк не підтвердив транзакцію
Клієнту необхідно звернутися до свого банку
902 PAYMENT_AUTH_FAILED: AuthCode 111
Відмова банку-емітента. Банк не підтвердив транзакцію
Клієнту необхідно звернутися до свого банку
902 PAYMENT_AUTH_FAILED: AuthCode 119
Відмова банку-емітента. Банк не підтвердив транзакцію
Клієнту необхідно звернутися до свого банку
902 PAYMENT_AUTH_FAILED: AuthCode 121
Відмова банку-емітента. Перевищено лімі за сумою зарахування.
Клієнту необхідно звернутися до свого банку.
902 PAYMENT_AUTH_FAILED: AuthCode 907
Відмова банку-еквайєра. Немає зв'язку із банком-емітентом.
Відмова банку-еквайєра. Немає зв'язку із банком-емітентом.
902 PAYMENT_AUTH_FAILED: AuthCode 106
Відмова банку-емітента. Банк не підтвердив транзакцію
Клієнту необхідно звернутися до свого банку
902 PAYMENT_AUTH_FAILED: AuthCode 104
Відмова банку-емітента. Банк не підтвердив транзакцію
Клієнту необхідно звернутися до свого банку
902 PAYMENT_AUTH_FAILED: AuthCode 100
Відмова банку-емітента. Банк не підтвердив транзакцію
Клієнту необхідно звернутися до свого банку
902 PAYMENT_AUTH_FAILED: AuthCode 010
Відмова банку-емітента. Банк не підтвердив транзакцію
Клієнту необхідно звернутися до свого банку
902 PAYMENT_AUTH_FAILED: AuthCode 200
Відмова банку-емітента. Банк не підтвердив транзакцію
Клієнту необхідно звернутися до свого банку
902 PAYMENT_AUTH_FAILED: AuthCode 101
Відмова банку-емітента. Термін дії картки закінчився
Клієнту необхідно використовувати іншу активну картку
902 PAYMENT_AUTH_FAILED: AuthCode 123
Відмова банку-емітента. Перевищено лімі за сумою зарахування
Клієнту необхідно звернутися до свого банку
992 Payment recipient count limit
Відмова банку-емітента. Перевищено лімі за сумою зарахування
Клієнту необхідно звернутися до свого банку
291 Technical/Communication problem
Відмова банку-емітента з технічних причин.
Повторити виплату за 15 хвилин.
java.lang.RuntimeException: C2Pd6:недостатньо коштів на рахунку партнера
Відмова банку-еквайєра. На транзитному рахунку недостатньо коштів на виплату. Термінал для виплати заблоковано
Поповніть транзитний рахунок та повторіть виплату
java.lang.Exception: C2Pa1:операція не може бути здійснена з технічних причин
Відмова банку-еквайєра з технічних причин. Тайм-аут авторизації
Повторіть виплату за 15 хвилин
java.lang.Exception: C2Pa4:перевищено ліміт одержувача за кількістю переказів
Овідмова банку-емітента. Перевищено ліміт за сумою зарахування
Клієнту необхідно звернутися до свого банку
java.lang.Exception: операція не може бути здійснена з технічних причин
Відмова банку-еквайєра з технічних причин.
Зверніться до Platon Support для перевірки причин відмови виплати
2 2 Transaction declined
Відмова банку-еквайєра без уточнення причини.
Зверніться до Platon Support для перевірки причин відмови виплати.
2 95 Amount over maximum
Відмова банку-еквайєра. Перевищено ліміт на узгоджену раніше суму виплат.
Зменшити суму виплати або звернеться до Platon Support.
2 115 Invalid recipient name
Відмова банку-еквайєра. Невірно вказано ПІБ одержувача кредиту.
Перевірити коректність заповнення ПІБ клієнта.
2 4 Unknown error code
Відмова банку-еквайєра без уточнення причини.
Зверніться до Platon Support для перевірки причин відмови виплати.
902 PAYMENT_AUTH_FAILED: AuthCode 120
Відмова банку-емітента. Карта заблокована.
Клієнту необхідно використовувати іншу активну картку.
902 FUNDING_AUTH_FAILED: AuthCode 124
Відмова банку-емітента. Банк не підтвердив транзакцію.
Клієнту необхідно звернутися до свого банку.
902 PAYMENT_AUTH_FAILED: AuthCode 208
Відмова банку-емітента. Карта загублена.
Клієнту необхідно використовувати іншу активну картку.
902 PAYMENT_AUTH_FAILED: AuthCode 209
Відмова банку-емітента. Карта загублена.
Клієнту необхідно використовувати іншу активну картку.
902 PAYMENT_AUTH_FAILED: AuthCode 904
Відмова банку-емітента. Банк не підтвердив транзакцію.
Клієнту необхідно звернутися до свого банку.
902 PAYMENT_AUTH_FAILED: AuthCode 908
Відмова банку-емітента. Банк не підтвердив транзакцію.
Клієнту необхідно звернутися до свого банку.
java.lang.Exception: C2Pa9:картку одержувача заблоковано банком емітентом.
Відмова банку-емітента. Карта заблокована.
Клієнту необхідно використовувати іншу активну картку.
java.lang.Exception: C2Pa3:операція відхилена банком емітентом картки одержувача.
Відмова банку-емітента. Банк не підтвердив транзакцію.
Клієнту необхідно звернутися до свого банку.
java.lang.Exception: C2Pa8:необхідно уточнити реквізити картки отримувача у банку емітента.
Відмова банку-емітента. Термін дії картки закінчився или карта неактивна.
Клієнту необхідно звернутися до свого банку.
java.lang.Exception: C2Pa6:банк емітент картки одержувача недоступний.
Відмова банку-емітента. Емітент недоступний.
Повторіть видачу за 15 хвилин.
java.lang.Exception: C2Pa11:Даний тип операції не доступний для картки Одержувача.
Відмова банку-емітента. Банк не підтвердив транзакцію.
Клієнту необхідно звернутися до свого банку.
КІД ВІДМОВИ | НА ЧИЇЙ СТОРОНІ ВІДМОВА | ОПИС КОДИ ВІДМОВИ | ЩО РОБИТИ |
902 PAYMENT_AUTH_FAILED: AuthCode | Банк-емітент | Емітент запитує заборону проведення транзакції без уточнення причини. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 010 | Банк-емітент | По карті перевищено ліміт за сумою зарахування. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 100 | Банк-емітент | Можливі причини: | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 101 | Банк-емітент | Закінчився термін дії картки або картка неактивна. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 102 | Банк-емітент | Власник картки підозрюється у шахрайстві. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 103 | Банк-емітент | Відмова без уточнення причин. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 104 | Банк-емітент | Можливі причини: | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 105 | Банк-емітент | Транзакція не підтверджена емітентом. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 106 | Банк-емітент | Можливі причини: | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 107 | Банк-емітент | Емітент запитує заборону проведення транзакції без уточнення причини. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 110 | Банк-емітент | Неправильне значення суми. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 111 | Банк-емітент | Закінчився термін дії картки або картка неактивна. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 114 | Банк-емітент | Недійсний рахунок чи збій конвертації валюти. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 117 | Банк-емітент | Можливі причини: | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 118 | Банк-емітент | Немає рахунку у файлі. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 119 | Банк-емітент | Порушення закону. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 120 | Банк-емітент | Карта заблокована. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 121 | Банк-емітент | По карті перевищено ліміт за сумою зарахування. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 122 | Банк-емітент | Порушення закону. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 123 | Банк-емітент | По карті перевищено ліміт за кількістю транзакцій. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 124 | Банк-емітент | Порушення закону. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 125 | Банк-емітент | Вийшов термін дії картки або припущено помилку при введенні. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 126 | Банк-емітент | Помилка обробки PIN. Можливо, карта неактивна. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 127 | Банк-емітент | Помилка обробки PIN. Можливо, карта неактивна. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 128 | Банк-емітент | Помилка обробки PIN. Можливо, карта неактивна. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 129 | Банк-емітент | Неправильно введено CVV2/CVC2. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 200 | Банк-емітент | Можливі причини: | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 201 | Банк-емітент | Вийшов термін дії картки або припущено помилку при введенні. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 202 | Банк-емітент | Можливі причини: | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 204 | Банк-емітент | Рахунок не активовано. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 205 | Банк-емітент | Власник картки підозрюється у шахрайстві. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 206 | Банк-емітент | Помилка обробки PIN. Можливо, карта неактивна. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 207 | Банк-емітент | Власник картки підозрюється у шахрайстві. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 208 | Банк-емітент | Карта загублена. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 209 | Банк-емітент | Карта вкрадена. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 902 | Банк-емітент | Можливі причини: | Повторити виплату. У разі повторної відмови Мерчанту звернутися на підтримку PSP Platon. |
902 PAYMENT_AUTH_FAILED: AuthCode 903 | Банк-емітент | Можливі причини: | Повторити виплату. У разі повторної відмови Мерчанту звернутися на підтримку PSP Platon. |
902 PAYMENT_AUTH_FAILED: AuthCode 904 | Банк-емітент | Отримане повідомлення не відповідало стандартам. | Повторити виплату. У разі повторної відмови Мерчанту звернутися на підтримку PSP Platon. |
902 PAYMENT_AUTH_FAILED: AuthCode 907 | Банк-емітент | Таймаут під час спроби зв'язку з банком-емітентом. | Мерчанту звернутися на підтримку PSP Platon. |
902 PAYMENT_AUTH_FAILED: AuthCode 908 | Банк-емітент | Таймаут під час спроби зв'язку з банком-емітентом. | Мерчанту звернутися на підтримку PSP Platon. |
902 PAYMENT_AUTH_FAILED: AuthCode 910 | Банк-емітент | Таймаут під час спроби зв'язку з банком-емітентом. | Мерчанту звернутися на підтримку PSP Platon. |
902 PAYMENT_AUTH_FAILED: AuthCode 911 | Банк-емітент | Відмова з технічних причин. | Повторити виплату. У разі повторної відмови звернутися на підтримку PSP Platon. |
902 PAYMENT_AUTH_FAILED: AuthCode 912 | Банк-емітент | Таймаут під час спроби зв'язку з банком-емітентом. | Мерчанту звернутися на підтримку PSP Platon. |
902 PAYMENT_AUTH_FAILED: AuthCode 913 | Банк-емітент | Отримано дублюючу транзакцію. | Мерчанту звернутися на підтримку PSP Platon. |
902 PAYMENT_AUTH_FAILED: AuthCode 913 | Банк-емітент | Не вдалось знайти вихідну транзакцію. | Мерчанту звернутися на підтримку PSP Platon. |
902 PAYMENT_AUTH_FAILED: AuthCode 920 | Банк-емітент | Помилка обробки PIN. Можливо, карта неактивна. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 921 | Банк-емітент | Помилка обробки PIN. PIN не змінено. Можливо, карта неактивна. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 922 | Банк-емітент | Помилка обробки PIN. Недопустимий PIN. Можливо, карта неактивна. | Клієнту звернутись на підтримку свого Банку. |
902 PAYMENT_AUTH_FAILED: AuthCode 936 | Банк-емітент | Таймаут під час спроби зв'язку з банком-емітентом. | Мерчанту звернутися на підтримку PSP Platon. |
903 Payment auth FAILED, auto reversal was sent | Банк-емітент | Можливі причини: | Клієнту звернутись на підтримку свого Банку. В случае массового получения ошибки – Мерчанту звернутися на підтримку PSP Platon. |
907 CROSSBORD_FORBIDDEN | Банк-еквайр | Заборона виплати на картку закордонного Банку. | Мерчанту замінити картку для виплати на картку українського Банку |
413 Unknown card type | Банк-еквайр | Невідомий тип картки. | Мерчанту необхідно перевірити реквізити картки. |
992 Payment recipient count limit | Банк-еквайр | По карті перевищено ліміт за сумою зарахування. | Клієнту звернутись на підтримку свого Банку. |
996 General merchant amount limit | Банк-еквайр | Перевищено ліміт суми видачі по мерчанту протягом доби. | Мерчанту повторити видачу після 00:00. Актуальні ліміти можна дізнатися у підтримки PSP Platon. |
Bad response forwarded status (XXX) | Банк-еквайр | Можливі причини: | Мерчанту Повторити виплату за 15 хвилин. В случае массового получения ошибки – Мерчанту звернутися на підтримку PSP Platon. |
291 Technical/Communication problem | Банк-еквайр | Можливі причини: | Мерчанту Повторити виплату за 15 хвилин. В случае массового получения ошибки – Мерчанту звернутися на підтримку PSP Platon. |
CREDITS_AMOUNT_CARD_24H | Платіжний провайдер | Перевищено максимальну суму виплати на одну картку протягом 24 годин. | Мерчанту Повторити виплату після 00:00. Актуальні ліміти можна дізнатися у підтримки PSP Platon. |
CREDIT_COUNT_CARD_24HOURS | Платіжний провайдер | Перевищено максимальну кількість виплат на одну картку протягом 24 годин. | Мерчанту Повторити виплату після 00:00. Актуальні ліміти можна дізнатися у підтримки PSP Platon. |
Account balance (X.XX) less then X.XX | Платіжний провайдер | На балансі недостатньо коштів для здійснення виплати. Актуальний баланс вказаний у коді помилки. | Мерчанту поповнити баланс на виплату. |
AMOUNT_TOO_BIG | Платіжний провайдер | Перевищено максимальну суму виплати на одну транзакцію. | Мерчантові зменшити суми виплати. Актуальні ліміти можна дізнатися у підтримки PSP Platon. |
Помилки запитів
Response: {"result":"ERROR","error_message":"Incorrect sign"}
Варіант 1
Невірно сформований зашифрований підпис.
Перевірте вірність сформованого підпису. Якщо помилку не знайшли зверніться до тих підтримки.
Варіант 2
Додані параметри, які не входять до цього запиту.
Перевірте список параметрів, що передаються. Якщо помилку не знайшли зверніться до тих підтримки.
Варіант 3
Неправильно зашифрована data.
Перевірити чи ви використовуєте UTF-8 і правильний формат параметрів.
Response: {"result":"ERROR","error_message":"Empty action"}
Варіант 1
Параметр action заповнений неправильно, порожній, чи не першому місці у списку параметрів запиту.
Перевірте список параметрів, що передаються. Якщо помилку не знайшли зверніться до тих підтримки.
Варіант 2
Запит надсилається методом GET, а не POST.
Надіслати запит методом POST.
Response: {"result":"ERROR","error_message":"Order already exists"}
Значення order_id має бути унікальним. Ця помилка говорить про те, що у вас вже була успішна транзакція з таким order_id.
Замінити значення order_id на новий унікальний.
Response: {"result":"ERROR","error_message":"Service error"}
Ситуація потребує уваги співробітників Platon.
Рекомендуємо звернутися до тех підтримки Platon для перевірки причини.
Response: {"result":"ERROR","error_message":"Previous transaction not completed"}
Ситуація потребує уваги співробітників Platon.
Рекомендуємо звернутися до тех підтримки Platon для перевірки причини.
Response: {"result":"ERROR","error_message":"Recurring not supported"}
rc_token заблокований, докладніше про причини можна дізнатися у розділі /wiki/spaces/docs/pages/1323303006
Рекомендуємо видалити цей rc_token з вашої бази даних та повторити верифікацію карти для отримання rc_token та можливості проведення транзакцій за новим токеном.
Response: {"result":"ERROR","error_message":"Initial transaction too old"}
card_token заблокований, докладніше про причини можна дізнатися у розділі /wiki/spaces/docs/pages/1323303006
Рекомендуємо видалити цей card_token з вашої бази даних та повторити верифікацію карти для отримання card_token та можливості проведення транзакцій за новим токеном.
Response: {"result":"ERROR","error_message":"Account error"}
Варіант 1
Ваша IP адреса не додана до нашого білого списку.
Зверніться до підтримки для додавання вашого IP в білий список.
Варіант 2
Цей функціонал вам не підключений.
Зверніться до підтримки для активації функціоналу.
Варіант 3
Запит надіслано не на те посилання.
Рекомендуємо звірити посилання для надсилання запиту із зазначеною у потрібному розділі документації.
Варіант 4
У запиті вказано неправильне або неіснуюче значення параметра channel_id.
Перевірте значення channel_id на достовірність або уточніть у тех підтримки доступні у вас значення.
Response: {"result":"ERROR","error_message":"Card token not found for current client"}
Надсилання запиту по цьому card_token відключена для цього API ключа так як card_token був отриманий на іншому API ключі.
Зверніться до тих підтримки для вирішення цієї ситуації.
Response: {"result":"ERROR","error_message":"Incorrect hash"}
Варіант 1
Неправильно сформовано зашифрований підпис.
Перевірте вірність сформованого підпису. Якщо помилка не знайдена зверніться до тех підтримки.
Варіант 2
Додані параметри, які не входять до цього запиту.
Перевірте список параметрів, що передаються. Якщо помилка не знайдена зверніться до тех підтримки.
Варіант 3
Запит був відправлений не з того API ключа, за яким був отриманий rc_token.
Рекомендуємо замінити API ключ на той, яким було отримано rc_token.
Response: {"result":"ERROR","error_message":"Duplicate request"}
За одну хвилину в систему було відправлено кілька однакових запитів.
Рекомендуємо перевірити ваш механізм надсилання запитів на наявність задвоєння.
Response: {"result":"ERROR","error_message":"Incorrect card_token value"}
Варіант 1
Запит було надіслано менш ніж через 10 хвилин після отримання токена.
Рекомендуємо налаштувати надсилання запитів щонайменше через 10 хвилин після отримання токена. Запит, за яким отримана ця помилка, необхідно повторити.
Варіант 2
В параметр card_token внесено неправильне значення.
Рекомендуємо перевірити вірність внесених даних у поле card_token отриманого з колбека раніше. Запит, за яким отримана ця помилка, необхідно повторити.
Response: {"result":"ERROR","error_message":"Not found card token"}
Варіант 1
Запит було надіслано менш ніж через 10 хвилин після отримання токена.
Рекомендуємо налаштувати надсилання запитів щонайменше через 10 хвилин після отримання токена. Запит, за яким отримана ця помилка, необхідно повторити.
Варіант 2
В параметр card_token внесено неправильне значення.
Рекомендуємо перевірити вірність внесених даних у поле card_token отриманого з колбека раніше. Запит, за яким отримана ця помилка, необхідно повторити.
'decline_reason' => '102: Token is not active'
rc_token заблокований, докладніше про причини можна дізнатися у розділі /wiki/spaces/docs/pages/1323303006
Рекомендуємо видалити цей rc_token з вашої бази даних та повторити верифікацію карти для отримання rc_token та можливості проведення транзакцій за новим токеном.
'error_message' => 'Wrong credit_date'
credit_date введено не відповідно до формату YYYY-MM-DD або вказано майбутню дату.
Рекомендуємо вказати в credit_date минулу дату чи поточну у форматі YYYY-MM-DD.
'error_message' => 'Invalid pan'
Invalid pan введено неправильний номер картки.
Звірте номер картки. Рекомендуємо перевіряти номер картки на дійсність перед відправкою у запиті використовуючи алгоритм Луна.
- No labels