Info |
---|
Цей функціонал буде активовано після вашого запиту в груповому чаті. |
Зміст
Table of Contents | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
Опис
Цей метод дозволить розмістити на вашому сайті або додатку окрему кнопку оплати Apple Pay.
Чекліст інтеграції
- Привести сайт / додаток до відповідності вимогам.
- Інтегрувати API Apple Pay.
- Створити сертифікати 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 з фінальним статусом.
- Повідомити клієнта про успішну / невідалу оплату.
Вимоги
Include Page | ||||
---|---|---|---|---|
|
Обмеження
Expand | ||
---|---|---|
| ||
Згідно обмежень Apple - Apple Pay працює:
|
Apple Pay API
Apple Pay API
Відповідно офіційної документації Apple Pay для генерації payment_token
необхідно виконати наступні кроки:
Перевірити можливість клієнтом оплати за допомогою Apple Pay
Code Block | ||
---|---|---|
| ||
if (window.ApplePaySession) { // The Apple Pay JS API is available. } |
Note |
---|
Увага! При створенні вами запиту на Apple в налаштуваннях Apple Pay вам потрібно вказати наступні значення: |
Code Block | ||
---|---|---|
| ||
supportedNetworks: [ 'masterCard', 'visa' ],
merchantCapabilities: [ 'supports3DS', 'supportsCredit', 'supportsDebit' ] |
2. Відобразити кнопку Apple Pay
4. Пройти валідацію сесії Apple Pay
5. Отримати платіжну авторизацію та платіжний об'єкт (токен) Apple Pay. Приклад:
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Налаштуйте відправку отриманого значення токену в параметрі payment_token
у відповідному форматі вказаному нижче:
Expand | ||
---|---|---|
| ||
|
Також рекомендуємо ознайомитись з демо наданого Apple для Apple Pay:
https://applepaydemo.apple.com/
Приклад інтеграції
API параметри
HTTP METHOD: POST
API ENDPOINT: https://secure.platononline.com/post/
Параметр | Значення | Опис | Особливості | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Код платіжного метода | ||||||||||||
| String | API ключ мерчанта | Ключ надається на пошту мерчанту | |||||||||||
| String | ID оплати в системі мерчанта | Max 255 символів | |||||||||||
| Number | Сума оплати |
| |||||||||||
|
| Валюта |
| |||||||||||
| String | Опис |
Max 1024 символів | |||||||||||
| String | Токен від Apple Pay | Відформатований по прикладу вище токен отриманий від Apple Pay
| |||||||||||
| String | IP-адреса платника | В форматі "ХХХ.ХХХ.ХХХ.ХХХ"
| |||||||||||
| String | E-mail платника |
Max 256 символів | |||||||||||
| String | Номер телефону платника |
Мах 32 символи | |||||||||||
| String | Посилання по якому буде відправлено платника після спроби оплати | Мах 1024 символів | |||||||||||
| String | Контрольний підпис |
| |||||||||||
| String | Ім'я платника | Мах 32 символи | |||||||||||
| String | Прізвище платника | Мах 32 символи | |||||||||||
| String | По батькові платника | Мах 32 символи | |||||||||||
| String | Дата народження платника | В форматі “YYYY-MM-DD” | |||||||||||
| String | Адреса платника | Мах 255 символів | |||||||||||
| String | Додаткова адреса платника | Мах 255 символів | |||||||||||
| String | Країна платника | Стандарт ISO 3166-1 alpha-2 | |||||||||||
| String | Штат платника | Стандарт ISO 3166-2 | |||||||||||
| String | Місто платника | Max 32 символи | |||||||||||
| String | Поштовий індекс платника | Max 32 символи | |||||||||||
| String | 10 додаткових полів | Max 1024 символи в кажному ext полі | |||||||||||
| String | Додатковий платіжний канал | Дозволяє перенаправляти платежі на інший банківський термінал | |||||||||||
|
| Включити асинхронний режим |
Стандартне значення | |||||||||||
|
| Стандартне значення |
Приклад запиту
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Info |
---|
Тестування
Тестування проводиться тільки в бойовому режимі використовуючи реальну картку прив'язану в Apple Pay.
Перевірка платежів
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Callback & Response
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Синхронний режим
Стандартний режим. Передавати async = N
не потрібно.
Асинхронний режим
Цей режим активується при передачі параметра async = Y
.
Include Page | ||||
---|---|---|---|---|
|
Include Page | ||||
---|---|---|---|---|
|
Помилки та рішення
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|