CF
CFActive
На главную

API документация

Интеграция с CFActive через REST API

Внимание: API находится в разработке. Документация будет дополнена после запуска публичного API.

Введение

CFActive API позволяет интегрировать функции платформы в ваши бизнес-системы. API построен по принципам REST и возвращает данные в формате JSON.

Аутентификация

Все запросы к API требуют аутентификации с помощью API-ключа. Ключ передаётся в заголовке Authorization:

Authorization: Bearer YOUR_API_KEY

API-ключ можно получить в личном кабинете в разделе «Настройки» → «API».

Базовый URL

https://api.cfactive.ru/v1

Endpoints

Получение баланса

GET /accounts/balance

Response:
{
  "success": true,
  "data": {
    "balances": [
      {
        "currency": "RUB",
        "available": "1250000.00",
        "hold": "50000.00"
      },
      {
        "currency": "USDT",
        "available": "12450.50",
        "hold": "0.00"
      }
    ]
  }
}

Получение курса

GET /rates?from=RUB&to=USDT

Response:
{
  "success": true,
  "data": {
    "from": "RUB",
    "to": "USDT",
    "rate": "0.01033",
    "inverse_rate": "96.85",
    "commission_percent": "1.5",
    "valid_until": "2026-01-12T12:05:00Z"
  }
}

Создание заявки на покупку

POST /orders/buy

Request:
{
  "from_currency": "RUB",
  "to_currency": "USDT",
  "amount": "100000.00"
}

Response:
{
  "success": true,
  "data": {
    "order_id": "ord_abc123",
    "status": "pending_payment",
    "from_amount": "100000.00",
    "to_amount": "1018.33",
    "rate": "96.85",
    "commission": "1500.00",
    "payment_details": {
      "bank": "ПАО "БАНК"",
      "account": "40702810XXXXXXXXXX",
      "bik": "044525XXX",
      "purpose": "Оплата по счёту ord_abc123"
    },
    "expires_at": "2026-01-12T12:05:00Z"
  }
}

Получение истории операций

GET /transactions?limit=10&offset=0

Response:
{
  "success": true,
  "data": {
    "transactions": [
      {
        "id": "txn_xyz789",
        "type": "buy",
        "from_currency": "RUB",
        "to_currency": "USDT",
        "from_amount": "100000.00",
        "to_amount": "1018.33",
        "rate": "96.85",
        "commission": "1500.00",
        "status": "completed",
        "created_at": "2026-01-10T14:30:00Z"
      }
    ],
    "total": 42,
    "limit": 10,
    "offset": 0
  }
}

Экспорт для 1С

GET /export/1c?from=2026-01-01&to=2026-01-12&format=xml

Response: XML file download

Коды ошибок

КодОписание
401Неверный или отсутствующий API-ключ
403Доступ запрещён (KYB не пройден или аккаунт заблокирован)
400Неверные параметры запроса
422Ошибка валидации данных
429Превышен лимит запросов (rate limiting)
500Внутренняя ошибка сервера

Rate Limiting

API имеет ограничение в 100 запросов в минуту на один API-ключ. При превышении лимита возвращается ошибка 429.

Webhooks

CFActive может отправлять уведомления о событиях (изменение статуса операции, зачисление средств и т.д.) на указанный вами URL. Настройка webhooks доступна в личном кабинете.

SDK и примеры

Официальные SDK пока находятся в разработке. Примеры интеграции будут доступны после запуска публичного API.

Поддержка

По вопросам интеграции обращайтесь:
Email: api@cfactive.ru
Telegram: @cfactive_dev