Skip to end of metadata
Go to start of metadata

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

Compare with Current View Page History

« Previous Version 20 Next »

Зміст

Опис

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

Верифікація картки використовується для:

  • Подтвердження особи власника картки

  • Отриманя CARD_TOKEN для наступних виплат та оплат.

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

Чекліст інтеграції

  • Привести сайт / додаток відповідно до вимог.
  • Передати тех підтримці PSP Platon посилання для Callback.
  • Повідомити тех підтримці PSP Platon ваші IP адреси серверів або про те, що буде використовуватись додаток (в цьому випадку обмеження по IP будуть зняті).
  • Провести інтеграцію цього API.
  • Відобразити клієнту форму вводу карткових даних.
  • Відправити запит з вашого сервера / додатку відповідно до цього API.
  • Отримати Response або Callback для редиректу платника на 3DS перевірку.
  • Відправити клієнту на 3DS перевірку.
  • Отримати Response або Callback зі статусом оплати від PSP Platon.
  • Повідомити клієнту про успішну / невдалу оплату.

Вимоги

 SSL сертифікат

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

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

 TLS 1.2

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

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

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

PSP Platon

Завантажити логотип PSP Platon

Visa

Завантажити логотип Visa

Завантажити логотип Verified by Visa

Mastercard

Рекомендації від Mastercard про коректне розміщення логотипа Mastercard

Завантажити логотип Mastercard

Завантажити логотип Mastercard SecureCode

Простір

Рекомендації від Простір про коректне розміщення логотипа Простір

Завантажити логотип Простір

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

Завантажити логотип, банери, "лапки" Monobank

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

Завантажити логотип, банери оплати частинами ПриватБанк

PCI DSS

Завантажити логотип PCI DSS

Apple Pay

Рекомендації від Apple про коректне розміщення логотипа Apple Pay

Завантажити логотип Apple Pay

Google Pay

Рекомендації від Google про коректне розміщення логотипа Google Pay на сайті

Рекомендації від Google про коректне розміщення логотипа Google Pay в додатку

Завантажити логотип Google Pay

Privat24

Завантажити логотип Privat24

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

  • Повідомити платника про умови підписки та регулярних списань та отримати підтвердження про згоду з умовами

  • Розмістити договір публічної оферти та отримати підтвердження від платника про згоду з умовами

  • Надати платнику можливість відмінити підписку

  • Згідно правил МПС дозволена лише одна спроба списання коштів з платника за добу

API параметри

HTTP METHOD: POST

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

Параметр

Значення

Опис

Особливості

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

SALE

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

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

String

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

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

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

VERIFY_ZERO

Ознака нульової верифікації

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

String

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

Max 32 символи

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

Number

Сума оплати

Вірний варіант

1.00

Невалідні варіанти

0
1
1.0
1,0
1,00

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

UAH

Валюта

Оплата можлива тільки в національній валюті гривні

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

String

Опис

Для кириличних символів необхідно використовувати формат UTF-8

Max 255 символів

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

Number

IP-адреса платника

В форматі "ХХХ.ХХХ.ХХХ.ХХХ"

IPv6 не підтримується

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

String

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

Max 255 символів

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

Number

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

В форматі "ХХХХХХХХХХХХХХХХ"
16 символів

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

Number

Місяць закінчення терміну дії картки

В форматі "ХХ"
2 символи

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

Number

Рік закінчення терміну дії картки

В форматі "ХХХХ"
4 символи

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

Number

CVV код

В форматі "ХХХ"
3 символи

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

String

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

Обов'язково валідна пошта

Відсутність пробілів

Max 255 символів

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

Number

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

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

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

Y
N

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

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

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

Y
N

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

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

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

String

Контрольний підпис

md5(
  strtoupper(
    strrev($email).
    $client_pass.
    strrev(
      substr($card_number,0,6).
      substr($card_number,-4)
    )
  )
)

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

Y
N

HOLD коштів

Стандартне значення N

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

Штат платника

Стандарт ISO 3166-2
В форматі "ХХ"
2 символи
Вказати NA, якщо немає даних

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

String

Місто платника

Max 32 символи
Вказати NA, якщо немає даних

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

String

Поштовий індекс платника

Max 32 символи

ext1, ext2, ext3, ext4, ext5, ext6, ext7, ext8, ext9, ext10
НЕ ОБОВ'ЯЗКОВИЙ

String

10 додаткових полей

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

 Приклад запиту на PHP
<?php
  $client_pass = '***';
  $data['action'] = 'SALE';
  $data['client_key'] = '***';
  $data['order_id'] = '546-4588';
  $data['order_amount'] = '1000.00';
  $data['order_currency'] = 'UAH';
  $data['order_description'] = 'test';
  $data['card_number'] = '4111111111111111';
  $data['card_cvv2'] = '159';
  $data['card_exp_month'] = '01';
  $data['card_exp_year'] = '2022';
  $data['payer_first_name'] = 'Ivan';
  $data['payer_last_name'] = 'Ivanov';
  $data['payer_phone'] = '380111111111';
  $data['payer_address'] = 'NA';
  $data['payer_country'] = 'UA';
  $data['payer_state'] = 'NA';
  $data['payer_city'] = 'Kiev';
  $data['payer_zip'] = '01001';
  $data['payer_email'] = 'sale@gmail.com';
  $data['payer_ip'] = '213.186.115.164';
  $data['req_token'] = 'Y';
  $data['recurring_init'] = 'N';
  $data['term_url_3ds'] = 'https://google.com';
  $data['hash'] = md5(
            strtoupper(
              strrev(
                $data['payer_email']).
                ($client_pass).
                strrev(
                  substr($data['card_number'],0,6).
                  substr($data['card_number'],-4)
                )
              )
            );

$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

Тестування

Цей API запит необхідно тестувати лише в бойовому режимі реальною карткою.

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

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

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 запит статуса

Для перевірки IA оплати

Для перевірки A2C виплат

Для перевірки C2A оплати

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 на ваш callback url.

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

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

 Response для редіректу платника на перевірку 3DS
{
  "action":"SALE",
  "result":"REDIRECT",
  "status":"3DS",
  "trans_id":"03346-89225- 87891",
  "order_id":"ORDER-12345",
  "trans_date":"2012-04-03 16:02:02",
  "redirect_url":"https://server_3ds.com/3ds.php",
  "redirect_params":
    {
      "PaReq":"bc5865698ae46de4eba4c51f0359a714",
      "MD":"111111111111111111111",
      "TermUrl":"https://term_url.com/3ds/67c14e5?trans_id=03346-89225-87891&hash=8b98db60fb3c24c14a6d7075241da38b"
    },
  "redirect_method":"POST"
}

Параметри

Опис

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

SALE

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

REDIRECT

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

3DS

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

Ордер ID в системі мерчанта

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

Ордер ID в платіжній системі

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

Дата транзакції. Час в UTC

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

URL для редіректу на 3DS

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

Дані для 3DS

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

Метод відправки параметрів 3DS (POST/GET)

 Проміжний Callback при наявності 3DS
array (
  'action' => 'SALE',
  'result' => 'REDIRECT',
  'status' => '3DS',
  'order_id' => '6b51033e-3e58-42e0-8ec3-88c97388018b',
  'trans_id' => '28738-47774-55067',
  'trans_date' => '2020-04-20 12:12:57',
  'redirect_url' => 'https://acs.privatbank.ua/pPaReqMC.jsp',
  'redirect_params' => 
    array (
      'PaReq' => 'eJxVUllu2zAQvYqg/4qUIlFUMGYgxykaoEqN2j4AIxGxUi2Olsb+K/qTG+S3VygKpGhRtL0CdaMMHWUDSHDeLJw3Cxxty8L6rJo2r6uJ7TrUtlSV1lleXUzs1fLtG24fCViuG6VmC5X2jRKQqLaVF8rKs4k9lx/VlRvw8ID7YRhFYcgDHrmeF/KQc8apG/jcFjCP0U/AmElgIscD8gjxyyZdy6oTINOr6emZwCgWcCAjhFI1pzPBXB66jAF5gFDJUolpPF29P1k4xx8SZxUD2Sshrfuqa3aCUx/II4C+KcS66zbtISGbQnZ1VeSVctK6BGJsQJ6ZzHsjtfjXNs9EMouv8e7w0uQy3p4t6HWy/IT4ZALEeEAmOyU86lHqe9RyvUM8QQRkrwdZGhKmcoplPQDYmBzxaDGGlwrAdjc4jZ2IOJqeEKjtpq4UemALn2TIVJsK/U3fDV/0nf4x3OL7b7jRf/Uv/dvS//Uf/X34Otzqn9a5PO8L1Zq6nV4iQxMK5Lni43dmEmmHTfZdN2CMMz/wzTj2OsMgx356B5TtKRgAxESRcdJk3BKUXm3PPfYf2CM=',
      'TermUrl' => 'https://secure.platononline.com/3ds/4de0025?operation_type=purchase&trans_id=28738-47774-55067&hash=***************************************************
    ),
  'redirect_method' => 'POST',
  'hash' => '********************************',
)

Параметри

Опис

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

SALE

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

REDIRECT

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

3DS

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

ID транзакції в системі мерчанта

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

ID транзакції в платіжній системі

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

Дата транзакції. Час в UTC

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

URL для редіректу на 3DS

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

Дані для 3DS

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

Метод відправки параметрів 3DS (POST/GET)

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

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

md5(
  strtoupper(
    strrev(email).
    client_pass.
    trans_id.
    strrev(
      substr(card,0,6).
      substr(card,-4)
    )
  )
)

Увага! Якщо в запиті на оплату не було вказано email, то при перевірці hash вкажіть пусте значення email.

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

Response про фінальний статус при оплаті з 3DS відсутній.

 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 відсутній.

 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 при наявності перевірки 3DS (варіант з GET)
array (
  'action' => 'SALE',
  'result' => 'REDIRECT',
  'status' => '3DS',
  'order_id' => '6b51033e-3e58-42e0-8ec3-88c97388018b',
  'trans_id' => '28738-47774-55067',
  'trans_date' => '2020-04-20 12:12:57',
  'redirect_url' => 'https://acs.privatbank.ua/pPaReqMC.jsp',
  'redirect_params' => 
    array (),
  'redirect_method' => 'GET',
  'hash' => '********************************',
)

Параметры

Описание

action
ОБЯЗАТЕЛЬНО

SALE

result
ОБЯЗАТЕЛЬНО

REDIRECT

status
ОБЯЗАТЕЛЬНО

3DS

order_id
ОБЯЗАТЕЛЬНО

ID транзакции в системе мерчанта

trans_id
ОБЯЗАТЕЛЬНО

ID транзакции в платежной системе

trans_date
ОБЯЗАТЕЛЬНО

Дата транзакции в платежной системе. Время UTC

redirect_url
ОБЯЗАТЕЛЬНО

URL, на который должен быть перенаправлен плательщик

redirect_params
ОБЯЗАТЕЛЬНО

Строка параметров

redirect_method
ОБЯЗАТЕЛЬНО

GET

Метод передачи параметров

hash
ОБЯЗАТЕЛЬНО

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

md5(
  strtoupper(
    strrev(email).
    CLIENT_PASS.
    strrev(payment_token)
  )
)

Внимание! Если при запросе на оплату не был указан email, то при проверке hash в подписи Callback следует указать пустое значение для email.

 Callback для редіректу платника на перевірку 3DS (варіант з POST)
array (
2  'action' => 'SALE',
3  'result' => 'REDIRECT',
4  'status' => '3DS',
5  'order_id' => '6b51033e-3e58-42e0-8ec3-88c97388018b',
6  'trans_id' => '28738-47774-55067',
7  'trans_date' => '2020-04-20 12:12:57',
8  'redirect_url' => 'https://acs.privatbank.ua/pPaReqMC.jsp',
9  'redirect_params' => 
10    array (
11      'PaReq' => 'eJxVUllu2zAQvYqg/4qUIlFUMGYgxykaoEqN2j4AIxGxUi2Olsb+K/qTG+S3VygKpGhRtL0CdaMMHWUDSHDeLJw3Cxxty8L6rJo2r6uJ7TrUtlSV1lleXUzs1fLtG24fCViuG6VmC5X2jRKQqLaVF8rKs4k9lx/VlRvw8ID7YRhFYcgDHrmeF/KQc8apG/jcFjCP0U/AmElgIscD8gjxyyZdy6oTINOr6emZwCgWcCAjhFI1pzPBXB66jAF5gFDJUolpPF29P1k4xx8SZxUD2Sshrfuqa3aCUx/II4C+KcS66zbtISGbQnZ1VeSVctK6BGJsQJ6ZzHsjtfjXNs9EMouv8e7w0uQy3p4t6HWy/IT4ZALEeEAmOyU86lHqe9RyvUM8QQRkrwdZGhKmcoplPQDYmBzxaDGGlwrAdjc4jZ2IOJqeEKjtpq4UemALn2TIVJsK/U3fDV/0nf4x3OL7b7jRf/Uv/dvS//Uf/X34Otzqn9a5PO8L1Zq6nV4iQxMK5Lni43dmEmmHTfZdN2CMMz/wzTj2OsMgx356B5TtKRgAxESRcdJk3BKUXm3PPfYf2CM=',
12      'TermUrl' => 'https://secure.platononline.com/3ds/4de0025?operation_type=purchase&trans_id=28738-47774-55067&hash=***************************************************
13    ),
14  'redirect_method' => 'POST',
15  'hash' => '********************************',
16)

Параметри

Опис

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

SALE

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

REDIRECT

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

3DS

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

ID транзакції в системі мерчанта

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

ID транзакції в платіжній системі

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

Дата транзакції. Час в UTC

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

URL для редіректу на 3DS

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

Дані для 3DS

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

Метод відправки параметрів 3DS (POST/GET)

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' => '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"
} 

При оплаті без 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"
} 

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

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

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

  • No labels