IA оплата Apple Pay™
Цей функціонал буде активовано після вашого запиту в груповому чаті.
Зміст
- 1.1 Зміст
- 1.2 Опис
- 1.3 Чекліст інтеграції
- 1.4 Вимоги
- 1.5 Обмеження
- 1.6 Apple Pay API
- 1.7 Apple Pay API
- 1.8 Приклад інтеграції
- 1.9 API параметри
- 1.10 Приклад запиту
- 1.11 Тестування
- 1.12 Перевірка платежів
- 1.13 Callback & Response
- 2 Синхронний режим
- 3 Асинхронний режим
Опис
Цей метод дозволить розмістити на вашому сайті або додатку окрему кнопку оплати Apple Pay.
Чекліст інтеграції
Вимоги
Обмеження
Apple Pay API
Створення сертифікатів Apple Pay
Apple Pay API
Відповідно офіційної документації Apple Pay для генерації payment_token
необхідно виконати наступні кроки:
Перевірити можливість клієнтом оплати за допомогою Apple Pay
if (window.ApplePaySession) {
// The Apple Pay JS API is available.
}
Увага! При створенні вами запиту на Apple в налаштуваннях Apple Pay вам потрібно вказати наступні значення:
supportedNetworks: [ 'masterCard', 'visa' ],
merchantCapabilities: [ 'supports3DS', 'supportsCredit', 'supportsDebit' ]
2. Відобразити кнопку Apple Pay
4. Пройти валідацію сесії Apple Pay
5. Отримати платіжну авторизацію та платіжний об'єкт (токен) Apple Pay. Приклад:
Налаштуйте відправку отриманого значення токену в параметрі payment_token
у відповідному форматі вказаному нижче:
Також рекомендуємо ознайомитись з демо наданого 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 | Сума оплати | Вірний варіант 1000.00 Невалідні варіанти 1000 |
|
| Валюта | Оплата можлива лише в національній валюті гривні. |
| String | Опис | Для кириличних символів необхідно використовувати формат UTF-8 Max 1024 символів |
| String | Токен від Apple Pay | Відформатований по прикладу вище токен отриманий від Apple Pay Приклад вказано вище у звернутому списку. |
| String | IP-адреса платника | В форматі "ХХХ.ХХХ.ХХХ.ХХХ" IPv6 на даний момент не підтримується та приведе до помилки |
| String | E-mail платника | Обов'язково валідна пошта. Відсутність пробілів. Max 256 символів |
| String | Номер телефону платника | Обов'язковий формат телефону 380… Мах 32 символи |
| String | Посилання по якому буде відправлено платника після спроби оплати | Мах 1024 символів |
| String | Контрольний підпис | md5(
strtoupper(
strrev($email).
$client_pass.
strrev($payment_token)
)
) |
| 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 | Додатковий платіжний канал | Дозволяє перенаправляти платежі на інший банківський термінал |
|
| Включити асинхронний режим | В асинхронному режимі обов'язкове використання коллбеків. Стандартне значення |
|
| Стандартне значення |
Приклад запиту
Тестування
Тестування проводиться тільки в бойовому режимі використовуючи реальну картку прив'язану в Apple Pay.
Перевірка платежів
Callback & Response
Синхронний режим
Стандартний режим. Передавати async = N
не потрібно.
Асинхронний режим
Цей режим активується при передачі параметра async = Y
.
Помилки та рішення