Обзор API
RollyPay API позволяет создавать платежи, получать баланс, курс и управлять выплатами по HTTP с использованием API-ключа кассы. Для интеграции без доступа в личный кабинет достаточно только API-ключа и секрета подписи вебхуков.
Base URL
Production: https://rollypay.io
Development: http://localhost:8080
Все эндпоинты API (кроме публичных страницы оплаты) имеют префикс /api/v1.
Основные сущности
| Сущность | Описание |
|---|---|
| Касса (terminal) | Привязка к вашему проекту. С кассой связаны api_key, signing_secret, лимиты и callback_url. |
| Платёж (payment) | Один приём оплаты. Создаётся через API, клиент переходит по pay_url, после оплаты приходит вебхук. |
| Вывод (payout) | Заявка на перевод USDT с баланса кассы на внешний кошелёк. |
Аутентификация
Для запросов к API используется заголовок X-API-Key с ключом кассы. В каждом запросе нужен уникальный X-Nonce (защита от повторного использования). Подробнее в Аутентификация.
Что дальше
- Аутентификация — API-ключ и nonce
- Платежи — создание, получение, список, статусы и страница оплаты
- Колбэки — вебхуки, подпись и повторные попытки