Apple Pay

Загальні положення

Apple Pay - електронний гаманець від компанії Apple, що дозволяє проводити платежі клієнтам на сайтах, а також через мобільні застосунки на iOS без необхідності щоразу вводити повні платіжні дані.

У вас є можливість інтегрувати Apple Pay на платіжну сторінку у один із таких способів:

• Tranzzo hosted-інтеграція (кнопка оплати Apple Pay розміщується на нашій платіжній сторінці).
• Інтеграція з API Apple Pay (розміщення кнопки оплати Apple Pay на вашому сайті).
  

До початку проведення інтеграції:

1. Зареєструйтесь у мерчант-порталі.
2. Ознайомтесь з переліком дозволених товарів.
3. Переконайтесь, що ваш сайт використовує HTTPS-протокол та підтримує TLS-протокол.

Tranzzo hosted-інтеграція

Підключення Apple Pay у цей спосіб не потребує від вас ніяких додаткових налаштувань: кнопка оплати Apple Pay відображається на нашій платіжній сторінці. Для підключення, проведіть hosted-інтеграцію та зверніться до Служби підтримки Tranzzo, щоб активувати цей метод.

Інтеграція з API Apple Pay

Для того, щоб додати Apple Pay на ваш сайт чи у мобільний застосунок:

1. Створіть обліковий запис Apple-розробника, що пов’язаний з однією з таких програм: Apple Developer Program, або Apple Developer Enterprise Program.
2. Отримайте персональний ідентифікатор мерчанта від Apple.
3. Ознайомтеся та використовуйте при налаштуванні Інструкцію до брендування від Apple.

Для проведення інтеграції необхідно:

Крок 1. Створення ідентифікатора мерчанта:

1. Увійдіть у свій обліковий запис розробника Apple.
2. Перейдіть до вкладки “Certificates, Identifiers & Profiles”.
3. У розділі “Identifiers” виберіть “Merchant ID”.
4. Додайте новий ідентифікатор мерчанта, натиснувши «+» у верхньому правому куті сторінки.
5. Заповніть необхідні поля та натисніть “Continue”.
6. Натисніть “Register”, щоб підтвердити свої дані.

Крок 2. Створення сертифіката мерчанта:

1. У розділі “Certificates, Identifiers & Profiles” виберіть ідентифікатор у бічній панелі, а потім виберіть ідентифікатор мерчанта у спливаючому меню вгорі праворуч.
2. Оберіть свій ідентифікатор мерчанта.
3. У розділі Apple Pay “Merchant Identity Certificate” натисніть “Create Certificate”.
4. Створіть запит на підписання сертифіката на своєму пристрої та натисніть “Continue”.
5. Натисніть “Choose file”.
6. У діалоговому вікні, що з’явиться, виберіть файл із сертифікатом (файл із розширенням .certSigningRequest), а потім натисніть “Choose”.
7. Натисніть “Continue”.
8. Натисніть “Download”.
9. Файл сертифіката (файл із розширенням .cer) з’явиться у папці “Downloads”.

Крок 3. Створення мерчантського домену (опційний):

Цей крок потрібен лише якщо ви хочете використовувати Apple Pay на сайті.

1. Увійдіть у свій обліковий запис розробника Apple.
2. У розділі “Certificates, Identifiers & Profiles” виберіть ідентифікатор у бічній панелі, а потім виберіть ідентифікатор мерчанта у спливаючому меню вгорі праворуч.
3. Оберіть свій ідентифікатор мерчанта.
4. У розділі “Merchant Domains” натисніть “Add Domain”.
5. Введіть повне доменне ім’я та натисніть “Save”.
6. Натисніть “Download”, помістіть завантажений файл у вказане місце та натисніть “Verify”.
7. Натисніть “Done”.

Крок 4. Перевірка мерчантського домену

1. Увійдіть у свій обліковий запис розробника Apple.
2. У розділі “Certificates, Identifiers & Profiles” виберіть ідентифікатор у бічній панелі, а потім виберіть ідентифікатор мерчанта у спливаючому меню вгорі праворуч.
3. Оберіть свій ідентифікатор мерчанта.
4. У розділі “Merchant Domains” натисніть “Verify” поруч із доменом та дотримуйтесь подальших інструкцій.

Щоб дізнатися серверні вимоги для використання Apple Pay, ознайомтеся з інформацією на порталі Apple-розробника.

Важливо

При використанні hosted-чекаута в режимі iframe або платіжного віджета, з міркувань безпеки метод Apple Pay підтримується лише на пристроях з Safari версій 17 та вище.

Інтеграція Apple Pay до мобільних застосунків (використання Мобільного SDK):

1. Проведіть інтеграцію з нашим Мобільним SDK.
2. Налаштуйте Apple Pay відповідно до гайду.
3. Передайте ApplePayConfig до PaymentsConfig (за замовчуванням ApplePayConfig є nil)

TranzzoPaymentSDK.setConfig(paymentConfig: PaymentsConfig(environment: .sandbox, currency: "your_currency", applePay: ApplePayConfig(merchantId: "yout_merchat_id", countryCode: "country_code")))

Зверніть увагу, що coutryCode повинен бути у форматі ISO 3166-1 alpha-2.

Інтеграція Apple Pay на сайті

1. Ознайомтесь з Інструкцією та можливостями платіжного методу Apple Pay.
2. Переконайтеся, що ваш пристрій або браузер підтримує Apple Pay.
3. Налаштуйте структуру платіжного запиту.
4. Пройдіть валідацію мерчанта.
5. Розпочніть платіжну сесію та опрацюйте платіж.
6. Відправте платіжні дані до API Tranzzo (див. наступний пункт “Списання”).

Списання:

Щоб провести списання з платіжної картки, збереженої в Apple Pay, у запиті direct-методу заповніть параметри payway та cc_token такими значеннями:

• payway: applepay
• mode: direct
• cc_token: applepay:${base64_applepay_encrypted_token}

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

curl -X POST \
  https://cpay.tranzzo.com/api/v1/payment \
  -H 'Content-Type: application/json' \
  -H 'X-API-Auth: CPAY <API_KEY>:<API_SECRET>' \
  -H 'X-API-Key: <ENDPOINTS_KEY>' \
  -d '{
  "pos_id": "<POS_ID>",
  "mode": "direct",
  "method": "purchase",
  "amount": 1,
  "currency": "UAH",
  "order_3ds_bypass": "supported",
  "cc_token": "applepay:123",
  "products":[],
  "customer_email": "[email protected]",
  "description": "Pay with Apple Pay Token",
  "order_id": "1234567890",
  "server_url": "https://callback.blackhole.com/callback",
  "result_url": "https://example.com/result"
 }'

Подальша обробка запиту здійснюється за стандартним платіжним процесом, притаманним для direct-інтеграції.