Интеграции

API-демо

Страница показывает, как выглядел бы обмен между мерчантом, платформой и провайдером. Реальных внешних API здесь нет.

Создание ордера

POST /api/integration/orders
Content-Type: application/json
X-Fintech-Timestamp: 1760000000
X-Fintech-Nonce: demo-nonce-001
X-Fintech-Signature: v1=<hmac_sha256>

{
  "merchantId": "merchant-orbita",
  "externalId": "API-ORDER-10001",
  "amount": 1250,
  "currency": "USD",
  "payType": "C2C",
  "resultMode": "json"
}

Пример ответа API

{
  "id": "clx_demo_order",
  "externalId": "API-ORDER-10001",
  "status": "CREATED",
  "amount": "1250",
  "currency": "USD",
  "commission": "31.25",
  "merchantNet": "1218.75",
  "paymentUrl": "https://pay.local/api/..."
}

Webhook-событие провайдера

POST /api/webhooks/provider
Content-Type: application/json
X-Webhook-Timestamp: 1760000000
X-Webhook-Signature: v1=<hmac_sha256>

{
  "orderId": "clx_demo_order",
  "providerOrderId": "fireex-7791",
  "status": "paid",
  "paidAmount": 1250,
  "currency": "USD"
}

Изменение статуса

PATCH /api/orders/{id}/status
Content-Type: application/json

{
  "status": "WAITING_PAYMENT"
}

Важно: демо-API берет роль из server-side sandbox session, а не из body.
Статусы нельзя перескакивать.
Правильная цепочка: CREATED -> WAITING_PAYMENT -> PAID -> CONFIRMED -> COMPLETED.

Курсы валют

GET /api/exchange-rates

{
  "baseCurrency": "RUB",
  "usdRubRate": 90.25,
  "isStale": false,
  "warning": null
}

POST /api/exchange-rates/refresh

Обновляет сохраненный справочный курс USD/RUB через серверный API route.

Что здесь происходит?

Мерчант создает ордер через API, а платформа возвращает ID, статус, сумму комиссии и платежную ссылку.

Webhook от провайдера обычно сообщает изменение статуса: оплачен, отменен, ошибка или спор.

В демо изменение статуса выполняется локальным API route, но только по разрешенной цепочке жизненного цикла.

Курсы валют нужны для управленческого эквивалента: исходные суммы остаются в RUB или USD, а дашборд показывает рублевую оценку.

Signed API и provider webhook проверяют HMAC-подписи. Signed API дополнительно проходит whitelist и risk engine, а webhook провайдера применяет статус к жизненному циклу ордера.

Создание ордера

POST /api/integration/orders Content-Type: application/json X-Fintech-Timestamp: 1760000000 X-Fintech-Nonce: demo-nonce-001 X-Fintech-Signature: v1=<hmac_sha256> { "merchantId": "merchant-orbita", "externalId": "API-ORDER-10001", "amount": 1250, "currency": "USD", "payType": "C2C", "resultMode": "json" }

{ "id": "clx_demo_order", "externalId": "API-ORDER-10001", "status": "CREATED", "amount": "1250", "currency": "USD", "commission": "31.25", "merchantNet": "1218.75", "paymentUrl": "https://pay.local/api/..." }

POST /api/webhooks/provider Content-Type: application/json X-Webhook-Timestamp: 1760000000 X-Webhook-Signature: v1=<hmac_sha256> { "orderId": "clx_demo_order", "providerOrderId": "fireex-7791", "status": "paid", "paidAmount": 1250, "currency": "USD" }

Изменение статуса

PATCH /api/orders/{id}/status Content-Type: application/json { "status": "WAITING_PAYMENT" } Важно: демо-API берет роль из server-side sandbox session, а не из body. Статусы нельзя перескакивать. Правильная цепочка: CREATED -> WAITING_PAYMENT -> PAID -> CONFIRMED -> COMPLETED.

GET /api/exchange-rates { "baseCurrency": "RUB", "usdRubRate": 90.25, "isStale": false, "warning": null } POST /api/exchange-rates/refresh Обновляет сохраненный справочный курс USD/RUB через серверный API route.