Apple Pay & Google Pay

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

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

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

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

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

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

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

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

Параметр	Значення
`gateway`	`evopay`
`gatewayMerchantId`	Унікальний ID (отримайте через Support)

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

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..."
        }
      }
    }
  }'

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

Аспект	Apple Pay	Google Pay
Платформа	iOS, macOS, Safari	Android, Chrome, інші
Потребує Merchant ID	Так	Ні (gatewayMerchantId через RozetkaPay)
Gateway параметр	—	`evopay`
Поле токена	`apple_pay.token`	`google_pay.token`