Оплата частинами ПриватБанк (Server - Server)

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

Зміст

Опис

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

Використовуючи цей розділ ви зможете реалізувати онлай та оффлайн оплату частинами.

Для використання в оффлайні вам необхідно інтегрувати це API до вашого ПЗ. Механізм взаємодії в такому випадку буде наступним:

Клієнт в оффлайн магазині говорить, що хоче оплатити частинами Monobank.
Менеджер просить назвати номер телефону прив'язаного до Monobank та вводить його разом з кількістю частин в вашому ПЗ, та відправляє запит відповідно до цього API методу.
Клієнту на телефон в додаток Monobank надходить повідомлення з пропозицією про можливість взяття оплати частинами, яке він може прийняти / відхилити, збільшити кількість частин (від наданої мерчантом кількості частин) з додатковою платою з боку клієнта за тарифами Monobank.
Після успішного підтвердження клієнтом в додатку до вас в систему буде відправлено коллбек з даними про платіж по результату якого менеджер може вибити чек та видати товар.

Минимальная сумма - отсутствует.

Максимальная сумма - 300 000 грн.

Этот функционал работает в два этапа. При успешном запросе общая сумма попадает в холд, после чего необходимо будет провести подтверждение списания для зачисления средств на ваш счет.

Подтверждение списания возможно несколькими способами:

Вручную в нашем личном кабинете
Настроить на стороне PSP Platon автоматическое списание в срок от 1 часа до 29 дней, о чем просьба сообщить в чат
Настроить автоматическое списание по API запросу списания с холда под вашу бизнес-логику

Внимание! Подтверждение списания и возврат производится в полном объеме суммы кредита. Частичное списание или частичный возврат запрещены.

Чеклист интеграции

Привести сайт / приложение к соответствию требованиям.
Передать тех поддержке PSP Platon ссылку для Callback.
Сообщить в тех поддержке PSP Platon ваши IP адреса сервера сайта или о том, что будет использоваться приложение (в этом случае ограничения по IP будут сняты).
Провести интеграцию данного API.
Отобразить клиенту форму для ввода номера телефона, который привязан к Приватбанк.
Отобразить клиенту выбор количества платежей на ваш выбор в в промежутках от 2 до 24 платежей (включительно).
Отправить запрос с вашего сервера / приложения согласно данного API.
Получить Response или Callback со статусом платежа от PSP Platon.
Уведомить клиента об успешном / не успешном запросе на оплату частями.

Требования к сайту

SSL сертифікат

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

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

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

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

Скачайте подходящие под стиль вашего сайта варианты логотипов.

TLS 1.2

Необходима поддержка протокола TLS не ниже версии 1.2

API параметры

HTTP METHOD: POST

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

Параметр	Значение	Описание	Особенности
`action` ОБЯЗАТЕЛЬНО	`SALE_PART`	Код платежного метода
`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	Описание платежа	Для кириллических символов необходимо использовать формат UTF-8 Max 255 символов
`payer_ip` ОБЯЗАТЕЛЬНО	Number	IP-адрес плательщика	В формате "ХХХ.ХХХ.ХХХ.ХХХ" IPv6 на данный момент не поддерживается
`term_url_3ds` ОБЯЗАТЕЛЬНО	String	Ссылка по которой будет отправлен клиент после успешной оплаты при прохождении 3DS	Max 255 символов
`payer_email` ОБЯЗАТЕЛЬНО	String	Почта плательщика	Обязательно валидная почта. Отсутствие пробелов. Max 255 символа
`payer_phone` ОБЯЗАТЕЛЬНО	Number	Финансовый номер телефона плательщика привязанный к Приватбанк	Обязательный формат телефона +380XXXXXXXXX
`ext4` ОБЯЗАТЕЛЬНО	String	`"{"available_parts_count":"n"}"`	JSON с количеством выбранных клиентом платежей от 2 до 24 (включительно), например `"{"available_parts_count":"6"}"`
`channel_id` ОБЯЗАТЕЛЬНО	privat_parts	Признак оплаты частями монобанк
`hash` ОБЯЗАТЕЛЬНО	String	Контрольная подпись	md5( strtoupper($pass). strrev($order_id) )
`async` НЕ ОБЯЗАТЕЛЬНО	`Y` `N`	Включить асинхронный режим	В асинхронном режиме обязательное использование коллбеков. По умолчанию значение `N`
`payer_first_name` НЕ ОБЯЗАТЕЛЬНО	String	Имя плательщика	Max 32 символа без пробелов
`payer_last_name` НЕ ОБЯЗАТЕЛЬНО	String	Фамилия плательщика	Max 32 символа без пробелов
`payer_address` НЕ ОБЯЗАТЕЛЬНО	String	Адрес плательщика	Max 256 символа Укажите `NA`, если нет данных
`payer_country` НЕ ОБЯЗАТЕЛЬНО	String	Страна плательщика	Стандарт ISO 3166-1 alpha-2 В формате "ХХ" 2 символа Укажите `NA`, если нет данных
`payer_state` НЕ ОБЯЗАТЕЛЬНО	String	Штат плательщика	Обязательный параметр для стран US, CA, AU Стандарт ISO 3166-2 В формате "ХХ" 2 символа Укажите `NA`, если нет данных
`payer_city` НЕ ОБЯЗАТЕЛЬНО	String	Город плательщика	Max 32 символа Укажите `NA`, если нет данных
`payer_zip` НЕ ОБЯЗАТЕЛЬНО	String	Почтовый индекс плательщика	Max 32 символа Укажите `NA`, если нет данных
`ext1`, `ext2`, `ext3`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` НЕ ОБЯЗАТЕЛЬНО	String	10 дополнительных полей	Max 1024 символа в каждом ext поле

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

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

<?php
  $client_pass = '***';
  $data['action'] = 'SALE_PART';
  $data['client_key'] = '***';
  $data['order_id'] = '546-4588';
  $data['order_amount'] = '1000.00';
  $data['order_currency'] = 'UAH';
  $data['order_description'] = 'test';
  $data['payer_first_name'] = 'Ivan';
  $data['payer_last_name'] = 'Ivanov';
  $data['payer_phone'] = '+380111111111';
  $data['payer_email'] = 'sale@gmail.com';
  $data['payer_ip'] = '213.186.115.164';
  $data['channel_id'] = 'privat_parts';
  $data['term_url_3ds'] = 'https://google.com';
  $data['ext4'] = '{"available_parts_count":"6"}';
  $hash = md5(
            strtoupper($client_pass).
            strrev($data['order_id'])
          );
?>

<!DOCTYPE html>
<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>sale</title>
  </head>
  <body onload="javascript:document.forms[0].submit()">
    <form action="https://secure.platononline.com/post-unq/" method="post">
      <input type="hidden" name="action" value="<?=$data['action']?>" />
      <input type="hidden" name="client_key" value="<?=$data['client_key']?>" />
      <input type="hidden" name="order_id" value="<?=$data['order_id']?>" />
      <input type="hidden" name="order_amount" value="<?=$data['order_amount']?>" />
      <input type="hidden" name="order_currency" value="<?=$data['order_currency']?>" />
      <input type="hidden" name="order_description" value="<?=$data['order_description']?>" />
      <input type="hidden" name="payer_first_name" value="<?=$data['payer_first_name']?>" />
      <input type="hidden" name="payer_last_name" value="<?=$data['payer_last_name']?>" />
      <input type="hidden" name="payer_phone" value="<?=$data['payer_phone']?>" />
      <input type="hidden" name="payer_email" value="<?=$data['payer_email']?>" />
      <input type="hidden" name="payer_ip" value="<?=$data['payer_ip']?>" />
      <input type="hidden" name="term_url_3ds" value="<?=$data['term_url_3ds']?>" />
      <input type="hidden" name="channel_id" value="<?=$data['channel_id']?>" />
      <input type="hidden" name="ext4" value="<?=$data['ext4']?>" />
      <input type="hidden" name="hash" value="<?=$hash?>" />
    </form>                                             
  </body>
</html>

Проверка платежей

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

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

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

Подробиці

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

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

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

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

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

Callback

Особенности работы с Callback

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 на відповідність первоначальної суми та ордера у вашій базі даних, які були вказані при створенні замовлення.

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

Данный режим работает по умолчанию. Передавать async = N не нужно.

При успешном редиректе (синхронный режим):

Промежуточный Response для редиректа на страницу ожидания результата

{
  "action":"SALE",
  "result":"REDIRECT",
  "status":"REDIRECT",
  "order_id":"546-4588",
  "trans_id":"39649-42645-29973",
  "trans_date":"2023-10-05 08:24:24",
  "redirect_url":"https:\/\/payparts2.privatbank.ua\/ipp\/v2\/payment?token=172F1869B9954BE8BFF6FD493294EAD",
  "redirect_params":null,
  "redirect_method":"GET"
}

Промежуточный Callback для редиректа на страницу ожидания результата

array (
  'action' => 'SALE',
  'result' => 'REDIRECT',
  'status' => 'REDIRECT',
  'order_id' => '546-45811465476r4367',
  'trans_id' => '36618-67917-29503',
  'trans_date' => '2022-10-19 13:39:51',
  'redirect_url' => 'https:\/\/payparts2.privatbank.ua\/ipp\/v2\/payment?token=172F1869B9954BE8BFF6FD493294EAD',
  'redirect_params' => null,
  'redirect_method" => 'GET',
)

При успешной оплате з HOLD (синхронный режим):

Response при успешном списании

{
  "action":"SALE",
  "result":"SUCCESS",
  "status":"PENDING",
  "order_id":"4385302",
  "trans_id":"28261-34099-19648",
  "descriptor":null,
  "trans_date":"2020-02-25 06:50:09"
}

Параметр	Описание
`action`	`SALE`
`result`	`SUCCESS`
`status`	`PENDING`
`order_id`	Уникальный ордер ID транзакции в системе мерчанта
`trans_id`	Уникальный ордер ID транзакции в системе Platon
`trans_date`	Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)
`descriptor`	NULL

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

array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'PENDING',
  'order_id' => '4385323',
  'trans_id' => '28261-47789-28578',
  'trans_date' => '2020-02-25 07:12:58',
  'descriptor' => NULL,
  'hash' => '********************************',
)

Параметр	Описание
`action`	`SALE`
`result`	`SUCCESS`
`status`	`PENDING`
`order_id`	Уникальный ордер ID транзакции в системе мерчанта
`trans_id`	Уникальный ордер ID транзакции в системе Platon
`trans_date`	Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)
`descriptor`	NULL
`hash`	Зашифрованная подпись для проверки достоверности коллбека md5( strtoupper( strrev(email). client_pass. trans_id ) ) Внимание! Если при запросе на оплату не был указан `email`, то при проверке `hash` в подписи Callback следует указать пустое значение для `email`.

При успешной оплате (синхронный режим):

Response при успешном списании

{
  "action":"SALE",
  "result":"SUCCESS",
  "status":"SETTLED",
  "order_id":"4385302",
  "trans_id":"28261-34099-19648",
  "descriptor":null,
  "trans_date":"2020-02-25 06:50:09"
}

Параметр	Описание
`action`	`SALE`
`result`	`SUCCESS`
`status`	`SETTLED`
`order_id`	Уникальный ордер ID транзакции в системе мерчанта
`trans_id`	Уникальный ордер ID транзакции в системе Platon
`trans_date`	Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)
`descriptor`	NULL

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,
  'hash' => '********************************',
)

Параметр	Описание
`action`	`SALE`
`result`	`SUCCESS`
`status`	`SETTLED`
`order_id`	Уникальный ордер ID транзакции в системе мерчанта
`trans_id`	Уникальный ордер ID транзакции в системе Platon
`trans_date`	Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)
`descriptor`	NULL
`hash`	Зашифрованная подпись для проверки достоверности коллбека md5( strtoupper( strrev(email). client_pass. trans_id ) ) Внимание! Если при запросе на оплату не был указан `email`, то при проверке `hash` в подписи Callback следует указать пустое значение для `email`.

При неуспешной оплате (синхронный режим):

Response при неуспешном списании

{
  "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"
}

Параметр	Описание
`action`	`SALE`
`result`	`DECLINED`
`status`	`DECLINED`
`order_id`	Уникальный ордер ID транзакции в системе мерчанта
`trans_id`	Уникальный ордер ID транзакции в системе Platon
`trans_date`	Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)
`descriptor`	NULL
`decline_reason`	Причина отмены транзакции

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 транзакции в системе Platon
`trans_date`	Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)
`descriptor`	NULL
`decline_reason`	Причина отмены транзакции
`hash`	Зашифрованная подпись для проверки достоверности коллбека md5( strtoupper( strrev(email). client_pass. trans_id ) ) Внимание! Если при запросе на оплату не был указан `email`, то при проверке `hash` в подписи Callback следует указать пустое значение для `email`.

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

Данный режим активируется при передаче async = Y. В этом режиме обязательно необходимо принимать callback на ваш callback url.

Промежуточный ответ (асинхронный режим):

Response о принятии запроса в обработку

{
  "action":"SALE",
  "result":"ACCEPTED",
  "order_id":"4385302",
  "trans_id":"28261-34099-19648",
  "trans_date":"2020-02-25 06:50:09"
}

Параметр	Описание
`action`	`SALE`
`result`	`ACCEPTED`
`order_id`	Уникальный ордер ID транзакции в системе мерчанта
`trans_id`	Уникальный ордер ID транзакции в системе Platon
`trans_date`	Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)

При успешном редиректе (aсинхронный режим):

Промежуточный Response для редиректа на страницу ожидания результата

{
  "action":"SALE",
  "result":"REDIRECT",
  "status":"REDIRECT",
  "order_id":"546-45811465476r4367",
  "trans_id":"36618-67917-29503",
  "trans_date":"2022-10-19 13:39:51",
  "redirect_url":"https:\/\/google.com",
  "redirect_params":null,
  "redirect_method":"GET"
}

Промежуточный Callback для редиректа на страницу ожидания результата

array (
  'action' => 'SALE',
  'result' => 'REDIRECT',
  'status' => 'REDIRECT',
  'order_id' => '546-45811465476r4367',
  'trans_id' => '36618-67917-29503',
  'trans_date' => '2022-10-19 13:39:51',
  'redirect_url' => 'https:\/\/google.com',
  'redirect_params' => null,
  'redirect_method" => 'GET',
)

При успешной оплате з HOLD (асинхронный режим):

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

array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'PENDING',
  'order_id' => '4385323',
  'trans_id' => '28261-47789-28578',
  'trans_date' => '2020-02-25 07:12:58',
  'descriptor' => NULL,
  'hash' => '********************************',
)

Параметр	Описание
`action`	`SALE`
`result`	`SUCCESS`
`status`	`PENDING`
`order_id`	Уникальный ордер ID транзакции в системе мерчанта
`trans_id`	Уникальный ордер ID транзакции в системе Platon
`trans_date`	Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)
`descriptor`	NULL
`hash`	Зашифрованная подпись для проверки достоверности коллбека md5( strtoupper( strrev(email). client_pass. trans_id ) ) Внимание! Если при запросе на оплату не был указан `email`, то при проверке `hash` в подписи Callback следует указать пустое значение для `email`.

При успешной оплате (асинхронный режим):

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,
  'hash' => '********************************',
)

Параметр	Описание
`action`	`SALE`
`result`	`SUCCESS`
`status`	`SETTLED`
`order_id`	Уникальный ордер ID транзакции в системе мерчанта
`trans_id`	Уникальный ордер ID транзакции в системе Platon
`trans_date`	Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)
`descriptor`	NULL
`hash`	Зашифрованная подпись для проверки достоверности коллбека md5( strtoupper( strrev(email). client_pass. trans_id ) ) Внимание! Если при запросе на оплату не был указан `email`, то при проверке `hash` в подписи Callback следует указать пустое значение для `email`.

При неуспешной оплате (асинхронный режим):

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 транзакции в системе Platon
`trans_date`	Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)
`descriptor`	NULL
`decline_reason`	Причина отмены транзакции
`hash`	Зашифрованная подпись для проверки достоверности коллбека md5( strtoupper( strrev(email). client_pass. trans_id ) ) Внимание! Если при запросе на оплату не был указан `email`, то при проверке `hash` в подписи Callback следует указать пустое значение для `email`.

Ошибки запросов

Список ошибок, их причин и возможных решений.

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 введен не верный номер карты.

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

Оплата частинами ПриватБанк (Server - Server)

Зміст

Опис

Чеклист интеграции

Рекомендации

Требования к сайту

PSP Platon

Visa

Mastercard

Простір

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