Разработчикам
От вызова API до статуса платежа.
Один REST API, JSON на вход и на выход, подпись API-ключом. Шесть шагов от ключа до подтверждённого платежа; каждый маршрут, поле и ошибка — в OpenAPI-документе.
- 1
Быстрый старт
Создайте ключ в кабинете, храните секрет на сервере, подписывайте запросы HMAC-SHA256.
Начать здесь → - 2
Создать платёж
Один POST /v1/invoices с суммой в монете или фиатной валюте; в ответе — checkout_url.
Создание платежа → - 3
Оплата клиентом
Отправьте плательщика на checkout_url: страница покажет адрес, QR, точную сумму, предупреждение о сети и живой статус.
Страница оплаты → - 4
Модель статусов
new → pending → paid; underpaid остаётся открытым до истечения TTL; expired и cancelled — конечные. Конечные состояния названы явно.
Статусы → - 5
Вебхуки
Подписанные события с повторами и тем же event id: проверьте подпись, обработайте один раз, ответьте 2xx в течение 10 секунд.
Вебхуки → - 6
Ошибки
Один конверт: сообщение для человека, машинный код и действие для восстановления — details.field называет неверное поле.
Ошибки →
POST /v1/invoices
Idempotency-Key: order-10042
X-API-Key: ck_live_… X-Timestamp: 1758000000 X-Signature: <hmac-sha256>
{ "amount": "49.90", "currency": "USD", "order_id": "10042", "return_url": "https://shop.example.com/orders/10042" }
→ 201 { "id": "4e2b…", "status": "new", "checkout_url": "https://cryptolike.net/pay/4e2b…", … }Справочник API
Каждый маршрут, поле и ошибка в OpenAPI-документе, доступном как Swagger UI.