Apple Pay & Google Pay

RozetkaPay підтримує оплату через Apple Pay та Google Pay для покращення користувацького досвіду.

Способи інтеграції

Є два варіанти інтеграції:

1. Через платіжну сторінку RozetkaPay — кнопки автоматично з’являться для клієнтів (потрібно лише увімкнути функцію)
2. Вбудовування у власний сайт/додаток — потребує додаткових кроків для генерації токенів

SDK для мобільних додатків

Для другого варіанта використовуйте готові SDK: вони беруть на себе платіжні кнопки, збір даних картки та обмін токенами з API.

Apple Pay

Вимоги

Для додавання Apple Pay entitlement потрібно мати:

• Apple Developer account (Apple Developer Program або Enterprise Program)
• Унікальний Merchant ID
• Ознайомлення з Brand guidelines

Інтеграція в мобільний додаток

Дотримуйтесь офіційної інструкції Apple.

Інтеграція на веб-сайт

Дотримуйтесь Apple Pay JS API документації.

Формат токена

Після успішної авторизації Apple Pay ви отримаєте JSON:

{
  "version": "EC_v1",
  "data": "zTMZDPumdE7h8oY/+31VMZd60dMaxB...",
  "signature": "MIAGCSqGSIb3DQEHA...",
  "header": {
    "ephemeralPublicKey": "MFkwEwYHKoZIzj0C...",
    "publicKeyHash": "3AKqH/wPWdQIBpGIv1PC4uDTbGouPgWbmUlFGiHopig=",
    "transactionId": "d6e63976191fdf051f7cb95e0e5da70a19c99a5576ececbfc0fd65ad2a7f2f74"
  }
}

Використання токена

Закодуйте весь JSON в Base64 і передайте в полі customer.payment_method.apple_pay.token:

curl -X POST https://api.rozetkapay.com/api/payments/v1/new \
  -u "login:password" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100,
    "currency": "UAH",
    "external_id": "order_12345",
    "mode": "direct",
    "customer": {
      "payment_method": {
        "type": "apple_pay",
        "apple_pay": {
          "token": "eyJ2ZXJzaW9uIjoiRUNfdjEiLC..."
        }
      }
    }
  }'

Google Pay

Документація

• API для мобільного додатку
• API для веб-сайту
• Brand guidelines для додатку
• Brand guidelines для веб

Конфігурація

При інтеграції Google Pay використовуйте:

Формат токена

Google Pay поверне об’єкт PaymentData, де поле paymentMethodData.tokenizationData.token містить зашифрований токен.

Використання токена

Закодуйте токен в Base64 і передайте в полі customer.payment_method.google_pay.token:

curl -X POST https://api.rozetkapay.com/api/payments/v1/new \
  -u "login:password" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100,
    "currency": "UAH",
    "external_id": "order_12345",
    "mode": "direct",
    "customer": {
      "payment_method": {
        "type": "google_pay",
        "google_pay": {
          "token": "eyJ0b2tlbiI6Ii..."
        }
      }
    }
  }'

Порівняння методів