RozetkaPay Payment API

Можливості API

Платежі

Створюйте одноразові та рекурентні платежі через Hosted або Direct Checkout.

Виплати

Здійснюйте виплати на картки клієнтів.

Підписки

Керуйте регулярними платежами та підписками.

Apple Pay & Google Pay

Підтримка мобільних платежів для кращого UX.

Швидкий старт

1. Отримайте credentials

   Перейдіть до розділу Авторизація та збережіть тестові login/password

2. Ознайомтесь з тестовими картками

   Використовуйте тестові картки для симуляції різних сценаріїв оплати

3. Створіть перший платіж

   Використайте API для створення платежу

4. Налаштуйте callbacks

   Додайте обробку webhook-повідомлень для отримання статусів

Популярні операції

Створити платіж POST /api/payments/v1/new

Статус платежу GET /api/payments/v1/info

Повернення коштів POST /api/payments/v1/refund

Створити виплату POST /api/payouts/v1/new

Авторизація

API використовує BasicAuth. Всі запити повинні містити заголовок авторизації:

curl -X POST https://api.rozetkapay.com/api/payments/v1/new \
  -u "login:password" \
  -H "Content-Type: application/json" \
  -d '{"amount": 100, "currency": "UAH", ...}'

Rate Limits

API підтримує до 1000 запитів/секунду. При перевищенні ліміту повертається статус 429 з заголовками:

Заголовок	Опис
X-RATELIMIT-LIMIT	Ліміт запитів на секунду
X-RATELIMIT-REMAINING	Залишок запитів
X-RATELIMIT-RESET	Час до скидання ліміту (сек)

Інтеграційні гайди

Callbacks (Webhooks) Обробка повідомлень про статус платежу

Apple Pay & Google Pay Інтеграція мобільних платежів

Widget Токенізація карток через віджет