Зміст
Table of Contents | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
Опис
Оплата по технології C2A дебет з обробкою карткових даних.
Info |
---|
Обов'язкова наявність у мерчанта PCI DSS. |
Tip |
---|
Увага! Цей запит виконується в декілька етапів:
|
Вимоги
API параметри №1
HTTP METHOD: POST
API ENDPOINT: https://secure.platononline.com/p2p-debit/
Параметр
Значення
Опис
Особливості
action
Status | ||||
---|---|---|---|---|
|
DEBIT_PREPARE
Код платіжного методу
async
Status | ||||
---|---|---|---|---|
|
Y
N
Асинхронний режим
Стандартне значення "N" можна не передавати
channel_id
Status | ||||
---|---|---|---|---|
|
String
Додатковий платіжний канал
Відправка коштів на окремий платіжний термінал
client_key
Status | ||||
---|---|---|---|---|
|
String
API ключ мерчанта
Ключ надається на пошту мерчанту
order_id
Status | ||||
---|---|---|---|---|
|
String
ID оплати в системі мерчанта
Max 32 символи
order_amount
Status | ||||
---|---|---|---|---|
|
Number
Сума оплати
Tip |
---|
Вірний варіант 1000.00 |
Warning |
---|
Невалідні варіанти 1000 |
order_currency
Status | ||||
---|---|---|---|---|
|
UAH
Валюта оплати
Info |
---|
Оплата можлива лише в національній валюті гривні |
order_description
Status | ||||
---|---|---|---|---|
|
String
Опис оплати
Note |
---|
Для криличних символів треба використовувати формат UTF-8 |
Max 255 символов
payer_first_name
Status | ||||
---|---|---|---|---|
|
String
Ім'я платника
Max 32 символів без пробілів
Вкажіть "NA" якщо немає даних
payer_last_name
Status | ||||
---|---|---|---|---|
|
String
Прізвище платника
Max 32 символів без пробілів
Вкажіть "NA" якщо немає даних
payer_address
Status | ||||
---|---|---|---|---|
|
String
Адреса платника
Max 256 символів
Вкажіть "NA" якщо немає даних
payer_country
Status | ||||
---|---|---|---|---|
|
String
Країна платника
Стандарт ISO 3166-1 alpha-2
В форматі "ХХ"
2 символа
payer_state
Status | ||||
---|---|---|---|---|
|
String
Штат платника
Стандарт ISO 3166-2
В форматі "ХХ"
2 символа
payer_city
Status | ||||
---|---|---|---|---|
|
String
Місто платника
Max 32 символи
Вкажіть "NA" якщо немає даних
payer_zip
Status | ||||
---|---|---|---|---|
|
String
Поштовий індекс платника
Max 32 символи
payer_email
Status | ||||
---|---|---|---|---|
|
String
Пошта платника
Info |
---|
Обов'язково валідна пошта |
Info |
---|
Без пробілів. |
Max 255 символа
payer_phone
Status | ||||
---|---|---|---|---|
|
String
Номер телефону платника
Info |
---|
Обов'язковий формат телефону 380… |
payer_ip
Status | ||||
---|---|---|---|---|
|
Number
IP-адреса платника
В форматі "ХХХ.ХХХ.ХХХ.ХХХ"
Note |
---|
IPv6 на даний момент не підтримується |
card_number
Status | ||||
---|---|---|---|---|
|
Number
Повний номер картки
В форматі "ХХХХХХХХХХХХХХХХ"
16 символів
card_exp_month
Status | ||||
---|---|---|---|---|
|
Number
Місяць терміну дії картки
В форматі "ХХ"
2 символа
card_exp_year
Status | ||||
---|---|---|---|---|
|
Number
Рік терміну дії картки
В форматі "ХХХХ"
4 символа
card_cvv2
Status | ||||
---|---|---|---|---|
|
Number
CVV код
В форматі "ХХХ"
3 символа
req_token
Status | ||||
---|---|---|---|---|
|
Y
N
Для формування card_token
Стандартне значення "N"
term_url_3ds
Status | ||||
---|---|---|---|---|
|
String
Посилання по якому буде відправлено платника після успішної / невдалої спроби оплати після 3DS
Max 255 символів
signature
Status | ||||
---|---|---|---|---|
|
String
Контрольний підпис
Code Block | ||
---|---|---|
| ||
sha1(
$pass.
strtolower(
implode(
'',
$action.
$client_key.
$order_id.
$order_amount.
$order_currency.
$order_description.
$card_number.
$card_exp_month.
$card_exp_year.
$card_cvv2.
$payer_first_name.
$payer_last_name.
$payer_phone.
$payer_address.
$payer_country.
$payer_state.
$payer_city.
$payer_zip.
$payer_email.
$payer_ip.
$term_url_3ds.
)
)
) |
Note |
---|
Значення в hash мають відповідати послідовності полів в самому запиті. |
API параметри №2
HTTP METHOD: POST
API ENDPOINT: https://secure.platononline.com/p2p-debit/
Параметр
Значення
Опис
Особливості
action
Status | ||||
---|---|---|---|---|
|
DEBIT_RUN
Код платежного методу
client_key
Status | ||||
---|---|---|---|---|
|
String
API ключ мерчанта
Ключ надається на пошту мерчанта
trans_id
Status | ||||
---|---|---|---|---|
|
String
ID оплати в системі PSP Platon
card_cvv2
Status | ||||
---|---|---|---|---|
|
Number
CVV код
В форматі "ХХХ"
3 символи
signature
Status | ||||
---|---|---|---|---|
|
String
Контрольний підпис
Code Block | ||
---|---|---|
| ||
sha1(
$pass.
strtolower(
implode(
'',
$action,
$client_key,
$trans_id,
$card_cvv2
)
)
) |
Приклад запиту
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Callback
title | Особливості роботи з Callback |
---|
title | Безпека |
---|
Проміжна ініциалізація по API запиту №1:
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Проміжний редірект на 3DS по API запиту №2:
Expand | |||||
---|---|---|---|---|---|
| |||||
|
При успішній оплаті:
title | Responce при успішній оплаті |
---|
Code Block |
---|
{
"action":"DEBIT_RUN",
"result":"SUCCESS",
"status":"SETTLED",
"order_id":"4385302",
"trans_id":"28261-34099-19648",
"trans_date":"2020-02-25 06:50:09",
"card_token":"8ef3111ac1093f6ccb817acef7f0845601d0994689a5f57949f94b0d086c7fe2"
} |
Параметр
Опис
action
DEBIT_RUN
result
SUCCESS
status
SETTLED
order_id
Унікальний ордер ID транзакції в системі мерчанта
trans_id
Унікальний ордер ID транзакції в системі PSP Platon
trans_date
Час проведення транзакції в форматі UTC (YYYY-MM-DD HH-MM-SS)
card_token
Зашифрований токен картки
title | Callback при успішній оплаті |
---|
Code Block | ||
---|---|---|
| ||
array (
'action' => 'DEBIT_RUN',
'result' => 'SUCCESS',
'status' => 'SETTLED',
'order_id' => '4385323',
'trans_id' => '28261-47789-28578',
'trans_date' => '2020-02-25 07:12:58',
'card_token' => '8ef3111ac1093f6ccb817acef7f0845601d0994689a5f57949f94b0d086c7fe2',
'hash' => '********************************',
) |
Параметр
Опис
action
DEBIT_RUN
result
SUCCESS
status
SETTLED
order_id
Унікальний ордер ID транзакції в системі мерчанта
trans_id
Унікальний ордер ID транзакції в системі PSP Platon
trans_date
Час проведення транзакції в форматі UTC (YYYY-MM-DD HH-MM-SS)
card_token
Зашифрований токен картки
hash
Зашифрований підпис для перевірки достовірності коллбеку
При невдалій оплаті:
title | Responce при невдалій оплаті |
---|
Code Block |
---|
{
"action":"DEBIT_RUN",
"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
DEBIT_RUN
result
DECLINED
status
DECLINED
order_id
Унікальний ордер ID транзакції в системі мерчанта
trans_id
Унікальний ордер ID транзакції в системі PSP Platon
trans_date
Час проведення транзакції в форматі UTC (YYYY-MM-DD HH-MM-SS)
decline_reason
Опис помилки
title | Callback при невдалій оплаті |
---|
Code Block | ||
---|---|---|
| ||
array (
'action' => 'DEBIT_RUN',
'result' => 'DECLINED',
'status' => 'DECLINED',
'order_id' => '4385323',
'trans_id' => '28261-47789-28578',
'trans_date' => '2020-02-25 07:12:58',
"decline_reason":"Declined by processing"
'hash' => '********************************',
) |
Параметр
Опис
action
DEBIT_RUN
result
DECLINED
status
DECLINED
order_id
Унікальний ордер ID транзакції в системі мерчанта
trans_id
Унікальний ордер ID транзакції в системі PSP Platon
trans_date
Час проведення транзакції в форматі UTC (YYYY-MM-DD HH-MM-SS)
decline_reason
Опис помилки
hash
Зміст
Table of Contents | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
Опис
Оплата Apple Pay по технології C2A дебет.
Tip |
---|
Увага! Цей запит виконується в декілька етапів:
|
Чекліст інтеграції
- Привести сайт/додаток до відповідності вимогам.
- Інтегрувати API Apple Pay.
- Створити разом з підтримкою PSP Platon сертифікати.
- Надіслати цю підтримку PSP Platon посилання для Callback.
- Повідомити в тих підтримці PSP Platon ваші IP адреси сервера сайту або про те, що буде використовуватись програма (у цьому випадку обмеження IP будуть зняті).
- Провести запит для отримання зашифрованих даних згідно з API Apple Pay.
- Після авторизації користувача та вибору реальної карти в гаманці Apple Pay поверне зашифровані дані.
- Провести запит згідно API PSP Platon, використовуючи зашифровані дані від Apple Pay.
- Отримати Response або Callback для редагування платника на 3DS перевірку.
- Надіслати клієнта на 3DS перевірку.
- Провести запит на отримання успішного Response або Callback зі статусом платежу SUCCESS від PSP Platon.
- Повідомити клієнта про успішну/не успішну оплату.
Вимоги
Include Page | ||||
---|---|---|---|---|
|
Сертифікати Apple Pay
Apple Pay API
Відповідно офіційної документації Apple Pay для генерації payment_token
необхідно виконати наступні кроки:
Перевірити можливість клієнтом оплати за допомогою Apple Pay
Code Block | ||
---|---|---|
| ||
if (window.ApplePaySession) {
// The Apple Pay JS API is available.
} |
Отримати платіжну авторизацію та платіжний об'єкт (токен) Apple Pay. Приклад:
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Налаштуйте відправку отриманого значення токену в параметрі payment_token
у відповідному форматі вказаному нижче:
Expand | ||
---|---|---|
| ||
|
Також рекомендуємо ознайомитись з демо наданого Apple для Apple Pay:
https://applepaydemo.apple.com/
API параметри №1
HTTP METHOD: POST
API ENDPOINT: https://secure.platononline.com/p2p-debit/
Параметр | Значення | Опис | Особливості | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Код платіжного методу |
| |||||||||||||
|
| Асинхронний режим | Стандартне значення "N" можна не передавати | |||||||||||||
| String | Додатковий платіжний канал | Відправка коштів на окремий платіжний термінал | |||||||||||||
| String | API ключ мерчанта | Ключ надається на пошту мерчанту | |||||||||||||
| String | ID оплати в системі мерчанта | Max 32 символи | |||||||||||||
| Number | Сума оплати |
| |||||||||||||
|
| Валюта оплати |
| |||||||||||||
| String | Опис оплати |
Max 255 символов | |||||||||||||
| String | Ім'я платника | Max 32 символів без пробілів | |||||||||||||
| String | Прізвище платника | Max 32 символів без пробілів | |||||||||||||
| String | Адреса платника | Max 256 символів | |||||||||||||
| String | Країна платника | Стандарт ISO 3166-1 alpha-2 | |||||||||||||
| String | Штат платника | Стандарт ISO 3166-2 | |||||||||||||
| String | Місто платника | Max 32 символи | |||||||||||||
| String | Поштовий індекс платника | Max 32 символи | |||||||||||||
| String | Пошта платника |
Max 255 символа | |||||||||||||
| String | Номер телефону платника |
| |||||||||||||
| Number | IP-адреса платника | В форматі "ХХХ.ХХХ.ХХХ.ХХХ"
| |||||||||||||
| String | Токен Apple Pay | Відформатований по прикладу вище токен отриманий від Apple Pay | |||||||||||||
|
| Для формування card_token | Стандартне значення "N" | |||||||||||||
| String | Посилання по якому буде відправлено платника після успішної / невдалої спроби оплати після 3DS | Max 255 символів | |||||||||||||
| String | ІПН платника | ||||||||||||||
| String | Контрольний підпис |
|
API параметри №2
HTTP METHOD: POST
API ENDPOINT: https://secure.platononline.com/p2p-debit/
Параметр | Значення | Опис | Особливості | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Код платежного методу |
| |||||||||||
| String | API ключ мерчанта | Ключ надається на пошту мерчанта | |||||||||||
| String | ID оплати в системі PSP Platon | ||||||||||||
| String | Контрольний підпис |
|
Приклад запиту
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Callback
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Include Page | ||||
---|---|---|---|---|
|