Платіжні методи

Для оплати доступні наступні платіжні методи:

• Оплата карткою (потрібен PCI DSS)
• Оплата токенізованою картою
• Оплата через гаманець (збережені картки)
• Google Pay
• Apple Pay

Вибір платіжного методу

Hosted mode

Користувач вибирає метод на сторінці чекаута RozetkaPay.

Direct mode

Платіжний метод передається в блоці customer.payment_method.

Оплата карткою

Обережно

Оплата карткою через direct методи можлива тільки за наявності PCI DSS. Для доступу зверніться до служби підтримки.

curl -X POST https://api.rozetkapay.com/api/payments/v1/new \
  -u "login:password" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "order_12345",
    "mode": "direct",
    "amount": 100,
    "currency": "UAH",
    "callback_url": "https://your-site.com/callback",
    "customer": {
      "external_id": "user_123",
      "phone": "380501234567",
      "payment_method": {
        "type": "cc",
        "cc": {
          "cc_number": "4242424242424242",
          "exp_month": 12,
          "exp_year": 25,
          "card_cvv": "123"
        }
      }
    }
  }'

Оплата токенізованою картою

Оплата збереженою карткою можлива після:

• Збереження карти через віджет
• Збереження карти на чекауті

curl -X POST https://api.rozetkapay.com/api/payments/v1/new \
  -u "login:password" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "order_12345",
    "mode": "direct",
    "amount": 100,
    "currency": "UAH",
    "callback_url": "https://your-site.com/callback",
    "customer": {
      "external_id": "user_123",
      "phone": "380501234567",
      "payment_method": {
        "type": "cc_token",
        "cc_token": {
          "token": "tok_2df5e29f-7ace-4e1a-9153-7a95e5d6a503",
          "use_3ds_flow": true,
          "save_to_wallet": true
        }
      }
    }
  }'

Параметр	Обов’язковий	Опис
token	Так	Токен картки
use_3ds_flow	Так	Використовувати 3DS (за замовч. true)
save_to_wallet	Ні	Зберегти в гаманець

Заувага

Для оплати без 3DS потрібно звернутись до служби підтримки.

Оплата через гаманець

Оплата збереженою карткою з гаманця користувача.

curl -X POST https://api.rozetkapay.com/api/payments/v1/new \
  -u "login:password" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "order_12345",
    "mode": "direct",
    "amount": 100,
    "currency": "UAH",
    "callback_url": "https://your-site.com/callback",
    "customer": {
      "external_id": "user_123",
      "phone": "380501234567",
      "payment_method": {
        "type": "wallet",
        "wallet": {
          "option_id": "opt_2df5e29f-7ace-4e1a-9153-7a95e5d6a503",
          "use_3ds_flow": true
        }
      }
    }
  }'

Параметр	Обов’язковий	Опис
option_id	Так	ID платіжного інструмента в гаманці
use_3ds_flow	Так	Використовувати 3DS
browser_fingerprint	Ні	Дані браузера користувача

Browser Fingerprint

{
  "browser_fingerprint": {
    "browser_accept_header": "text/html,application/xhtml+xml",
    "browser_color_depth": "24",
    "browser_ip_address": "192.168.1.100",
    "browser_java_enabled": "false",
    "browser_language": "uk",
    "browser_screen_height": "1080",
    "browser_time_zone": "Europe/Kyiv",
    "browser_time_zone_offset": "+0200",
    "browser_user_agent": "Mozilla/5.0..."
  }
}

Google Pay

Детальна інтеграція: Apple Pay & Google Pay

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

Важливо:

• Параметр gateway має бути evopay
• gatewayMerchantId надається службою підтримки
• Токен має бути закодований в Base64

Apple Pay

Детальна інтеграція: Apple Pay & Google Pay

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

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

Метод	Тип	Потрібен PCI DSS	3DS
cc	Картка напряму	Так	Так
cc_token	Токен картки	Ні	Опційно
wallet	Гаманець	Ні	Опційно
google_pay	Google Pay	Ні	Опційно
apple_pay	Apple Pay	Ні	Опційно