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

{
  "success": true,
  "data": [
    {
      "symbol": "USDT",
      "is_active": true,
      "balance": "1250.00",
      "available": "1250.00",
      "pending_deposit": "0.00",
      "pending_withdraw": "0.00",
      "balance_usdt": "1250.00",
      "balance_source": "ledger",
      "addresses": [
        { "network": "TRX", "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE" },
        { "network": "ETH", "address": "0x742d35Cc6634C0532925a3b..." }
      ]
    },
    {
      "symbol": "BTC",
      "is_active": true,
      "balance": "0.05432100",
      "available": "0.05432100",
      "pending_deposit": "0.00",
      "pending_withdraw": "0.00",
      "balance_usdt": "2150.50",
      "balance_source": "ledger",
      "addresses": []
    }
  ],
  "ts": 1706000000
}

{
  "success": true,
  "data": {
    "symbol": "USDT",
    "is_active": true,
    "balance": "1250.00",
    "available": "1250.00",
    "pending_deposit": "0.00",
    "pending_withdraw": "0.00",
    "balance_usdt": "1250.00",
    "balance_source": "ledger",
    "addresses": [
      { "network": "TRX", "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE" }
    ]
  },
  "ts": 1706000000
}

{
  "symbol": "USDT",
  "network": "TRX"
}

{
  "success": true,
  "data": {
    "symbol": "USDT",
    "available": "0.00",
    "addresses": [
      { "network": "TRX", "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE" }
    ]
  },
  "ts": 1706000000
}

{
  "success": true,
  "data": {
    "id": 12345,
    "username": "john_doe",
    "email": "john@example.com",
    "email_verified": null,
    "kyc_status": "verified",
    "tariff": null,
    "sso_client_id": "wallet-web",
    "created_at": "1700000000"
  },
  "ts": 1706000000
}

{
  "success": true,
  "data": {
    "symbol": "USDT",
    "addresses": [
      { "network": "TRX", "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE" }
    ]
  },
  "ts": 1706000000
}

{
  "success": true,
  "data": {
    "methods": [
      { "code": "SBER", "name": "Сбербанк", "type": "sbp" },
      { "code": "TINKOFF", "name": "Т-Банк", "type": "sbp" },
      { "code": "ALFA", "name": "Альфа-Банк", "type": "sbp" }
    ]
  },
  "ts": 1706000000
}

{
  "currency": "RUB",
  "amount": "10000",
  "payment_provider_alias_code": "SBER"
}

{
  "success": true,
  "data": {
    "transaction_id": "7ad2bfd0-673f-455a-b75b-95a949a7476a",
    "status": "processing",
    "currency": "RUB",
    "amount": "10000",
    "credited_amount": null,
    "fee": null,
    "payment_provider_alias_code": "SBER",
    "requisites": "https://qr.nspk.ru/...",
    "requisites_qr_code": "https://qr.nspk.ru/...",
    "invoice_public_url": "https://qr.nspk.ru/...",
    "expires_at": "2026-08-14T12:00:00Z",
    "created_at": "2026-08-14T11:00:00Z"
  },
  "ts": 1706000000
}

{
  "success": true,
  "data": {
    "transaction_id": "7ad2bfd0-673f-455a-b75b-95a949a7476a",
    "status": "success",
    "currency": "RUB",
    "amount": "6500",
    "credited_amount": "6383",
    "fee": "117",
    "payment_provider_alias_code": "SBER",
    "requisites": "https://qr.nspk.ru/...",
    "requisites_qr_code": "https://qr.nspk.ru/...",
    "invoice_public_url": "https://qr.nspk.ru/...",
    "expires_at": "2026-08-14T12:00:00Z",
    "created_at": "2026-08-14T11:00:00Z"
  },
  "ts": 1706000000
}

{
  "symbol": "USDT",
  "amount": "100",
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "bch_code": "TRX",
  "idempotency_key": "unique-withdraw-key-123"
}

{
  "success": true,
  "data": {
    "transaction_id": "...",
    "symbol": "USDT",
    "amount": "100",
    "fee": "1.0",
    "total": "101.0",
    "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "network": "TRX",
    "status": "processing"
  },
  "ts": 1706000000
}

{
  "success": true,
  "data": {
    "currency": "RUB",
    "banks": [
      { "bank_code": "TINKOFF", "name": "T-Pay" },
      { "bank_code": "SBER", "name": "S-Pay" },
      { "bank_code": "ALFA", "name": "A-Pay" }
    ]
  },
  "ts": 1706000000
}

{
  "currency": "RUB",
  "amount": "500",
  "recipient": "79992122496",
  "bank_code": "TINKOFF",
  "idempotency_key": "unique-fiat-withdraw-key-456"
}

{
  "success": true,
  "data": {
    "transaction_id": "68182a10-9f8a-4c06-a1bf-4d5d66841284",
    "currency": "RUB",
    "amount": "500.00",
    "amount_fact": null,
    "fee": "15.00",
    "total": "515.00",
    "status": "processing",
    "recipient": "7999****96",
    "bank_code": "TINKOFF"
  },
  "ts": 1706000000
}

{
  "success": true,
  "data": {
    "transaction_id": "68182a10-9f8a-4c06-a1bf-4d5d66841284",
    "status": "success",
    "currency": "RUB",
    "amount": "500.00",
    "amount_fact": "500.00",
    "fee": "15.00",
    "total": "515.00",
    "bank_code": "TINKOFF",
    "recipient": "7999****96",
    "created_at": 1706000000,
    "updated_at": 1706000120,
    "error": null
  },
  "ts": 1706000120
}

{
  "symbol": "USDT",
  "amount": "100",
  "to_username": "john_doe",
  "to_user_id": null,
  "comment": "Payment for services",
  "idempotency_key": "unique-transfer-key-789"
}

{
  "success": true,
  "data": {
    "task_id": "celery-task-id-...",
    "symbol": "USDT",
    "amount": "100",
    "to": "john_doe",
    "status": "processing"
  },
  "ts": 1706000000
}

{
  "currency": "USDT",
  "amount": "1000"
}

{
  "success": true,
  "data": {
    "status": "ok"
  },
  "ts": 1706000000
}

{
  "currency": "USDT",
  "amount": "500"
}

{
  "success": true,
  "data": {
    "status": "ok"
  },
  "ts": 1706000000
}

{
  "success": true,
  "data": [
    {
      "pair": "BTC-USDT",
      "base": "BTC",
      "quote": "USDT",
      "last_price": "97450.50",
      "bid_price": "97448.00",
      "ask_price": "97453.00",
      "volume_24h": "12450000",
      "high_24h": "98100.00",
      "low_24h": "96800.00",
      "price_change_24h": "0.0124"
    }
  ],
  "ts": 1706000000
}

{
  "success": true,
  "data": {
    "symbol": "BTCUSDT",
    "priceTo": "71114.201",
    "priceOut": "69706.098",
    "price": "70410.2",
    "mainSymbol": "BTC",
    "minorSymbol": "USDT",
    "quote_asset_precision": 7,
    "base_asset_precision": 6,
    "step": "0.000001",
    "minValue": "0.000001",
    "min_value_minor": "5",
    "maxValue": "230",
    "max_value_minor": "8000000",
    "limit_price_step": "0.005",
    "price_step": "0.1"
  },
  "ts": 1706000000
}

{
  "success": true,
  "data": ["NAKA", "SIGN", "ARKM", "BTC", "ETH", "SOL"],
  "ts": 1706000000
}

{
  "success": true,
  "data": {
    "symbol": "BTCUSDT",
    "priceTo": "71114.201",
    "priceOut": "69706.098",
    "price": "70410.2",
    "mainSymbol": "BTC",
    "minorSymbol": "USDT",
    "quote_asset_precision": 7,
    "base_asset_precision": 6,
    "step": "0.000001",
    "minValue": "0.000001",
    "min_value_minor": "5",
    "maxValue": "230",
    "max_value_minor": "8000000",
    "limit_price_step": "0.005",
    "price_step": "0.1"
  },
  "ts": 1706000000
}

{
  "from_symbol": "USDT",
  "to_symbol": "BTC",
  "from_amount": "100",
  "type": "market"
}

{
  "success": true,
  "data": {
    "order_id": "550e8400-e29b-41d4-a716-446655440000",
    "from_symbol": "USDT",
    "to_symbol": "BTC",
    "from_amount": "100",
    "to_amount": "0.00231",
    "type": "market",
    "order_price": null,
    "status": "processing"
  },
  "ts": 1706000000
}

{
  "from_symbol": "USDT",
  "to_symbol": "BTC",
  "from_amount": "500",
  "type": "limit",
  "order_price": "42000.00"
}

{
  "success": true,
  "data": {
    "order_id": "550e8400-e29b-41d4-a716-446655440001",
    "from_symbol": "USDT",
    "to_symbol": "BTC",
    "from_amount": "500",
    "to_amount": null,
    "type": "limit",
    "order_price": "42000.00",
    "status": "processing"
  },
  "ts": 1706000000
}

{
  "success": true,
  "data": {
    "cancelled": true,
    "order_id": "550e8400-e29b-41d4-a716-446655440001",
    "status": "cancelled"
  },
  "ts": 1706000000
}

{
  "success": true,
  "data": [
    {
      "order_id": "...",
      "from_symbol": "USDT", "to_symbol": "BTC",
      "from_amount": "100", "to_amount": "0.00231",
      "type": "market",
      "status": "completed", "created_at": "2024-01-15T14:30:00Z"
    },
    {
      "order_id": "...",
      "from_symbol": "USDT", "to_symbol": "ETH",
      "from_amount": "500", "to_amount": null,
      "type": "limit", "order_price": "2100.00",
      "status": "processing", "created_at": "2024-01-15T15:00:00Z"
    }
  ],
  "ts": 1706000000
}

{
  "success": true,
  "data": [
    { "trading_pair": "USDT/RUB", "status": "active", "base": "USDT", "quote": "RUB" }
  ],
  "ts": 1706000000
}

{
  "success": true,
  "data": {
    "USDT": { "available": "5000.00", "locked": "100.00" },
    "RUB": { "available": "150000.00", "locked": "0.00" }
  },
  "ts": 1706000000
}

{
  "success": true,
  "data": {
    "bids": [
      { "price": "92.45", "amount": "5000" },
      { "price": "92.40", "amount": "12000" }
    ],
    "asks": [
      { "price": "92.55", "amount": "3000" },
      { "price": "92.60", "amount": "8000" }
    ]
  },
  "ts": 1706000000
}

{
  "success": true,
  "data": [
    { "id": "...", "price": "92.50", "amount": "100", "side": "buy", "time": "2024-01-15T14:30:00Z" }
  ],
  "ts": 1706000000
}

{
  "success": true,
  "data": {
    "pair": "USDT/RUB", "last": "92.50", "high": "93.10",
    "low": "91.80", "volume": "1250000", "change": "+0.5%"
  },
  "ts": 1706000000
}

{
  "pair": "USDT/RUB",
  "side": "buy",
  "type": "market",
  "amount": "100"
}

{
  "pair": "USDT/RUB",
  "side": "buy",
  "type": "market",
  "quote_amount": "10000"
}

{
  "pair": "USDT/RUB",
  "side": "sell",
  "type": "limit",
  "amount": "500",
  "price": "93.00"
}

{
  "success": true,
  "data": {
    "order_id": "ord_limit_xyz789",
    "pair": "USDT/RUB",
    "side": "sell",
    "type": "limit",
    "amount": "500",
    "price": "93.00",
    "status": "open"
  },
  "ts": 1706000000
}

{
  "success": true,
  "data": [
    { "id": "...", "pair": "USDT/RUB", "side": "buy", "type": "limit",
      "price": "92.00", "amount": "100", "filled": "0", "status": "open" }
  ],
  "ts": 1706000000
}

{
  "success": true,
  "data": [
    { "id": "...", "pair": "USDT/RUB", "side": "buy",
      "price": "92.45", "amount": "100", "fee": "0.1", "time": "2024-01-15T14:30:00Z" }
  ],
  "ts": 1706000000
}

{
  "success": true,
  "data": {
    "id": "3f1c9a2e-8b7d-4e6a-9c11-2a5f4d7e0b9c",
    "order_number": 10432,
    "user_id": "b2c9e7a1-4f83-4d2a-9e6b-1c0f5a8d3e21",
    "side": "buy",
    "type": "market",
    "price": null,
    "amount": "100",
    "filled": "100",
    "status": "filled",
    "created_at": "2026-07-24T14:28:00.123456",
    "trading_pair": "USDT/RUB",
    "execution_message": "Order executed successfully",
    "avg_execution_price": "92.35",
    "total_fee": "9.235",
    "user_input_price": null,
    "user_input_price_total": "10000",
    "user_input_amount": null,
    "locked_quote_amount": "10000"
  },
  "ts": 1753363680
}

{
  "success": true,
  "data": {
    "from_symbol": "BTC",
    "to_symbol": "ETH",
    "rate": "16.468",
    "min_amount_usdt": "10",
    "max_amount_usdt": "50000",
    "expires_in_seconds": 30
  },
  "ts": 1706000000
}

{
  "from_symbol": "BTC",
  "to_symbol": "ETH",
  "from_amount": "0.5"
}

{
  "success": true,
  "data": {
    "quote_id": "qt_abc123def456",
    "from_symbol": "BTC",
    "to_symbol": "ETH",
    "from_amount": "0.5",
    "to_amount": "8.234",
    "rate": "16.468",
    "expires_in_seconds": 30
  },
  "ts": 1706000000
}

{
  "quote_id": "qt_abc123def456",
  "idempotency_key": "your-unique-key-123"
}

{
  "success": true,
  "data": {
    "uid": "conv_op_abc123",
    "from_symbol": "BTC",
    "to_symbol": "USDT",
    "from_amount": "0.01",
    "to_amount": "704.10",
    "rate": "70410.2",
    "status": "completed"
  },
  "ts": 1706000000
}

{
  "success": true,
  "data": [
    {
      "code": "RUB",
      "name": "Российский рубль",
      "symbol": "₽",
      "decimals": 2,
      "min_amount": "100.00",
      "max_amount": "250000.00"
    }
  ],
  "ts": 1706000000
}

{
  "success": true,
  "data": ["0G", "1INCH", "AAVE", "ADA", "BTC", "ETH", "USDT", "..."],
  "ts": 1706000000
}

{
  "success": true,
  "data": {
    "crypto": "USDT", "fiat": "RUB", "direction": "sell",
    "rate": "92.50", "min_amount": "10", "max_amount": "100000"
  },
  "ts": 1706000000
}

{
  "crypto_symbol": "USDT",
  "fiat_code": "RUB",
  "direction": "sell",
  "amount": "100"
}

{
  "success": true,
  "data": {
    "quote_id": "qt_fiat_abc123",
    "crypto_symbol": "USDT",
    "fiat_code": "RUB",
    "direction": "sell",
    "crypto_amount": "100",
    "fiat_amount": "9250.00",
    "rate": "92.50",
    "fee": "1.00",
    "expires_at": "2024-01-20T12:35:00Z"
  },
  "ts": 1706000000
}

{
  "crypto_symbol": "USDT",
  "fiat_code": "RUB",
  "direction": "sell",
  "from_amount": "100",
  "quote_id": "qt_fiat_xyz789"
}

{
  "success": true,
  "data": {
    "uid": "fiat_conv_xyz789",
    "crypto_symbol": "USDT",
    "fiat_code": "RUB",
    "direction": "sell",
    "crypto_amount": "100",
    "fiat_amount": "9250.00",
    "status": "completed"
  },
  "ts": 1706000000
}

{
  "success": true,
  "data": [
    { "uid": "...", "type": "crypto", "from_symbol": "BTC", "to_symbol": "ETH",
      "from_amount": "0.5", "to_amount": "8.234", "status": "completed" }
  ],
  "ts": 1706000000
}

{
  "amount": "10",
  "payment_method": "balance_usdt",
  "source_symbol": "USDT",
  "card_type": "SHOPPING",
  "is_apple_pay_available": false
}

// rub_sbp — в ответе qr/ссылка на оплату
{ "amount": "10", "payment_method": "rub_sbp", "card_type": "SHOPPING" }

// onchain_usdt — в ответе адрес депозита
{ "amount": "10", "payment_method": "onchain_usdt", "onchain_network": "trc20", "card_type": "SHOPPING" }

{
  "success": true,
  "data": {
    "id": 123, "card_type": "SHOPPING", "status": "ACTIVE",
    "number": "4111 **** **** 1234", "cvc": "***",
    "date_expired": "12/27", "payment_system": "VISA",
    "balance": "150.00", "region": "WW"
  },
  "ts": 1706000000
}

{
  "amount": "50",
  "source_symbol": "USDT",
  "payment_method": "crypto"
}

{
  "success": true,
  "data": [
    { "id": 1, "title": "Игры", "slug": "games", "is_active": true, "products_count": 42 },
    { "id": 2, "title": "Развлечения", "slug": "entertainment", "is_active": true, "products_count": 18 },
    { "id": 3, "title": "Музыка", "slug": "music", "is_active": true, "products_count": 7 }
  ],
  "ts": 1706000000
}

{
  "product_id": 123,
  "face_value": 1000,
  "symbol": "USDT"
}

{
  "success": true,
  "data": {
    "product_id": 123,
    "face_value": 1000,
    "crypto_amount": "10.85",
    "symbol": "USDT",
    "fee": "0.15",
    "total": "11.00"
  },
  "ts": 1706000000
}

{
  "product_id": 123,
  "face_value": 1000,
  "symbol": "USDT",
  "email": "user@example.com"
}

{
  "success": true,
  "data": {
    "order_id": "gc_ord_abc123",
    "product_id": 123,
    "face_value": 1000,
    "crypto_amount": "11.00",
    "symbol": "USDT",
    "status": "processing"
  },
  "ts": 1706000000
}

{
  "success": true,
  "data": [
    { "id": "...", "product": "Steam 1000₽", "face_value": 1000,
      "cost_usdt": "11.50", "status": "completed", "code": "XXXX-YYYY-ZZZZ" }
  ],
  "ts": 1706000000
}

{
  "success": true,
  "data": {
    "id": 2,
    "name": "MegaCom",
    "category_alias": "mobile",
    "country": "Кыргызская Республика",
    "payment_type": "SIMPLIFIED",
    "fixed_payment": false,
    "requires_check": false,
    "inputs": [
      { "name": "account", "required": true, "title": "Номер", "regexp": "^0\\d{9}$" }
    ],
    "required_fields": []
  },
  "ts": 1706000000
}

{
  "service_id": 2,
  "debit_currency": "RUB",
  "client_amount": 500
}

{
  "success": true,
  "data": {
    "service_id": 2,
    "service_name": "MegaCom",
    "client_amount": "512.40",
    "client_currency": "RUB",
    "quote_expires_at": "1706000300",
    "payment_type": "SIMPLIFIED",
    "fixed_payment": false,
    "requires_check": false
  },
  "ts": 1706000000
}

{
  "service_id": 2,
  "debit_currency": "RUB",
  "client_amount": "512.40",
  "field_values": { "account": "0555123456" }
}

{
  "success": true,
  "data": {
    "success": true,
    "agent_transaction_id": "agent-tx-uuid",
    "client_amount": "512.40",
    "client_currency": "RUB",
    "requires_identity": false,
    "check_snapshot": { "agent_transaction_id": "agent-tx-uuid" }
  },
  "ts": 1706000000
}

{
  "service_id": 2,
  "debit_currency": "RUB",
  "client_amount": "512.40",
  "field_values": { "account": "0555123456" },
  "quote_expires_at": "1706000300"
}

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "service_id": 2,
    "status": "CREATED",
    "status_for_client": "wait",
    "client_amount": "512.40",
    "client_currency": "RUB",
    "requisite": "0555123456"
  },
  "ts": 1706000000
}

{
  "success": true,
  "data": {
    "is_active": true,
    "invoice_commission_percent": "0.5",
    "hedging_commission_percent": "0.5",
    "shift_commission_to_payer": false,
    "is_hedging_enabled": true,
    "min_invoice_amount_usdt": "1",
    "max_invoice_amount_usdt": "10000000",
    "default_lifetime_minutes": 1440,
    "min_lifetime_minutes": 5,
    "max_lifetime_minutes": 43200
  }
}

curl -X POST "https://alfabit.org/api/v2/integration/invoices" \
  -H "X-API-Key: pk_live_..." \
  -H "X-API-Signature: ..." \
  -H "X-API-Timestamp: ..." \
  -H "Idempotency-Key: 4b8c8a1e-3f2c-4f3a-9c0d-2b3a4b5c6d7e" \
  -H "Content-Type: application/json" \
  -d '{"amount":"100","currency":"RUB","payment_policy":"alfabit_only"}'

{
  "symbol": "USDT",
  "bch_code": "TRX",
  "amount": "100"
}

{
  "symbol": "USDT",
  "bch_code": "TRX",
  "amount": "250.50",
  "currency": "USDT",
  "description": "Order #ORD-12345",
  "life_time_minutes": 180,
  "is_hedging": true,
  "hedging_symbol": "BTC",
  "payment_policy": "all",
  "show_receiver_publicly": false,
  "idempotency_key": "4b8c8a1e-3f2c-4f3a-9c0d-2b3a4b5c6d7e"
}

{
  "success": true,
  "data": {
    "invoice_id": "01J7HZ...",
    "status": "wait",
    "symbol": "USDT",
    "network": "TRX",
    "address": "TXa1B2...",
    "memo_tag": null,
    "amount_requested": "250.50",
    "amount_requested_currency": "USDT",
    "amount_to_pay": "250.50",
    "exchange_rate": null,
    "commission": {
      "commission_percent": "0.5",
      "commission_amount": "1.25",
      "is_paid_by_payer": false
    },
    "amount_received": null,
    "txid": null,
    "payment_source": "blockchain",
    "description": "Order #ORD-12345",
    "is_hedging": true,
    "hedging_symbol": "BTC",
    "is_payer_marked_paid": false,
    "payment_url": "https://alfabit.org/en/pub/invoice/order/01J7HZ...",
    "alfabit_payment_policy": "all",
    "is_open_amount": false,
    "show_receiver_publicly": false,
    "created_at": "1747325000",
    "expires_at": "1747335800"
  }
}

{
  "success": true,
  "data": {
    "invoice_id": "01J7HZ...",
    "status": "success",
    "symbol": "USDT",
    "network": "TRX",
    "address": "TXa1B2...",
    "amount_requested": "250.50",
    "amount_received": "250.50",
    "txid": null,
    "payment_source": "alfabit_balance",
    "alfabit_payment_route": "direct_internal_transfer",
    "alfabit_payer_symbol": "USDT",
    "alfabit_payer_network": "TRX",
    "alfabit_payment_intent_uid": "intent_01J...",
    "is_payer_marked_paid": true,
    "payer_name": "И. Иван Иванович",
    "payment_url": "https://alfabit.org/en/pub/invoice/order/01J7HZ...",
    "show_receiver_publicly": false,
    "created_at": "1747325000",
    "expires_at": "1747335800"
  }
}

{
  "success": true,
  "data": [ /* массив объектов как в GET /invoices/{invoice_id} */ ],
  "pagination": {
    "total": 137,
    "limit": 20,
    "offset": 0
  }
}

{
  "success": true,
  "data": { /* тот же объект инвойса со status="failed" */ }
}

{
  "success": false,
  "error": {
    "code": "INVALID_STATUS",
    "message": "Cannot cancel invoice in status 'success'"
  }
}

{
  "success": true,
  "data": {
    "payment_url": "https://alfabit.org/en/pub/invoice/order/01J7HZ..."
  }
}

{
  "success": true,
  "data": {
    "template_uid": "01J8AB...",
    "status": "wait",
    "is_active": true,
    "payment_url": "https://alfabit.org/en/pub/invoice/permanent/01J8AB...",
    "invoice_currency": "USDT",
    "description": "Coffee Shop on Tverskaya 7",
    "payments_total": 0,
    "is_hedging": false,
    "hedging_symbol": null,
    "payment_policy": "all",
    "show_receiver_publicly": true,
    "show_payments_count_publicly": true,
    "template_max_active_children": 100,
    "created_at": "1747325000"
  }
}

{
  "success": true,
  "data": {
    "invoice_id": "01J8CD...",
    "status": "wait",
    "symbol": "USDT",
    "network": "TRX",
    "address": "TXa1B2...",
    "amount_requested": "12.50",
    "amount_requested_currency": "USDT",
    "amount_to_pay": "12.50",
    "payment_source": "blockchain",
    "description": "Receipt POS-AAA-9876",
    "payment_url": "https://alfabit.org/en/pub/invoice/order/01J8CD...",
    "alfabit_payment_policy": "all",
    "show_receiver_publicly": true,
    "created_at": "1747326000",
    "expires_at": "1747326900",
    "parent_template_uid": "01J8AB...",
    "external_payment_id": "POS-AAA-9876"
  }
}

{
  "uid": "01J8CD...",
  "status": "success",
  "invoice_amount": "12.50",
  "invoice_currency": "USDT",
  "amount_received": "12.50",
  "symbol": "USDT",
  "bch_code": "TRX",
  "txid": "0x1a2b3c...",
  "public_comment": "Receipt POS-AAA-9876",
  "external_payment_id": "POS-AAA-9876",
  "created_at": "1747326000",
  "finished_at": "1747326200"
}

{
  "amount": "5000.00",
  "external_payment_id": "MM-1234",
  "idempotency_key": "order-mm-1234-attempt-1",
  "description": "Order #1234",
  "payer_phone": "+79001234567",
  "payer_ip": "203.0.113.10",
  "payer_user_agent": "Mozilla/5.0 ...",
  "payer_device_id": "fp_7c9e6679",
  "invoice_fee_mode": "deduct_from_amount"
}

{
  "success": true,
  "data": {
    "status": "kyc_required",
    "kyc_required": true,
    "payer_status": "not_started",
    "processing": false,
    "manual_review": false,
    "client_action_required": false,
    "retry_comment": null,
    "required_documents": ["passport_main", "passport_registration"],
    "commission_percent": "1.0",
    "upload_documents_endpoint": "/api/v1/integration/checkout/payers/79001234567/documents",
    "poll_status_endpoint": "/api/v1/integration/checkout/payers/79001234567"
  }
}

{
  "success": true,
  "data": {
    "payment_uid": "01J8...",
    "external_payment_id": "MM-1234",
    "status": "created",
    "amount": "5000.00",
    "amount_to_pay": "5000.00",
    "currency": "RUB",
    "invoice_fee_mode": "deduct_from_amount",
    "commission_percent": "1.0",
    "commission_amount": "50.00"
  }
}

{
  "success": true,
  "data": {
    "phone": "+79001234567",
    "kyc_status": "pending",
    "expected_payer_name": null,
    "low_confidence": false,
    "processing": true,
    "poll_status_endpoint": "/api/v1/integration/checkout/payers/79001234567"
  }
}

{
  "success": true,
  "data": {
    "phone": "+79001234567",
    "kyc_status": "approved",
    "verified_at": "2026-07-27T10:39:26.657298+00:00",
    "expected_payer_name": "И. Иван Иванович",
    "required_documents": ["passport_main", "passport_registration"],
    "processing": false,
    "manual_review": false,
    "client_action_required": false,
    "retry_comment": null
  }
}

{
  "success": true,
  "data": {
    "payment_uid": "01J8...",
    "status": "success",
    "amount": "5000.00",
    "currency": "RUB",
    "qr_url": "https://qr.nspk.ru/...",
    "qr_payload": "https://qr.nspk.ru/...",
    "expected_payer_name": "И. Иван Иванович",
    "payer_name": "И. Иван Иванович"
  }
}

{
  "success": true,
  "data": {
    "channels": [
      { "code": "sbp_1", "name": "SBP #1", "fee_percent": 1.0 }
    ],
    "commission_percent": "1.0"
  }
}

{ "success": true, "data": { "usdt_rub": 92.5, "usdt_kgs": 89.1 }, "ts": 1706000000 }

{
  "adt": 1,                               // adults: 1-9
  "chd": 0,                               // children: 0-9
  "inf": 0,                               // infants: 0-9
  "trip_class": "e",                      // e / b / f
  "segments": [                           // массив сегментов (1 = OW, 2 = RT, 3+ = multi-city)
    { "from": "SVO", "to": "LED", "date": "2026-06-15" },
    { "from": "LED", "to": "SVO", "date": "2026-06-20" }
  ],
  "lang": "ru"
}

{
  "success": true,
  "data": {
    "flights": [
      {
        "id": "21DKEASYOWE100...",              // длинный ID рейса
        "recommendation_id": "21DKEASYOWE100...", // алиас на id (для удобства)
        "duration": 185,                         // общая длительность в минутах
        "segments_direction": [
          {
            "direction": 0,
            "segments": [
              {
                "dep": { "city": "Frankfurt", "airport_code": "FRA", "datetime": "15.06.2026 17:35:00", "ts": 1781534100 },
                "arr": { "city": "Istanbul", "airport_code": "SAW", "datetime": "15.06.2026 21:40:00", "ts": 1781548800 },
                "flight_info": { "flight_number": "996", "airline": "Pegasus Airlines", "airline_code": "PC" },
                "baggage": { "is_baggage": false, "baggage_pieces": 0 }
              }
            ]
          }
        ],
        "short_result": {
          "duration": 185,
          "isBaggage": true, "baggageWeight": 20, "baggagePiece": 1,
          "transfers": []
        },
        "price": { /* цены в разных валютах */ },
        "hash": "ce7069..."
      }
    ]
  },
  "ts": 1714063200
}

// Используйте flights[N].recommendation_id (или flights[N].id) для:
//   GET  /avia/fare-families?recommendation_id=...
//   POST /avia/create-order  { recommendation_id, ... }
//   POST /avia/book          { recommendation_id, ... }

{
  "order_uuid": "550e8400-e29b-41d4-a716-446655440000",
  "recommendation_id": "REC_12345",        // ОБЯЗАТЕЛЬНО. Если выбирали тариф — nonUpgradedId /
                                           // upgradeId из /avia/fare-families, иначе тот же id,
                                           // что в /avia/create-order
  "client_email": "user@example.com",
  "client_phone": "+79001234567",
  "passengers": [
    {
      "first_name": "IVAN",                // КАК В ПАСПОРТЕ — латиницей для международных рейсов
      "last_name": "IVANOV",
      "type": "adt",                       // adt / chd / inf
      "birth_date": "1990-01-15",          // YYYY-MM-DD
      "document_type": "passport",         // passport / national_id / birth_certificate (для inf)
      "document_number": "1234567890",
      "document_expire": "2030-01-15",
      "citizenship": "RU",
      "sex": "M"                           // M / F
    }
  ],
  "lang": "ru"
}

Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000

{
  "success": true,
  "data": {
    "order_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "billing_number": "BN-AVIA-2026-78901",
    "status": "booked",
    "ticket_time_limit": "2026-04-25T22:00:00Z"   // до этого времени надо оплатить
  },
  "ts": 1714063200
}

{
  "order_uuid": "550e8400-e29b-41d4-a716-446655440000",
  "currency_in_code": "USDT_TRC20"   // USDT_TRC20 / BTC / ETH / RUB / ...
}

{
  "success": true,
  "data": {
    "invoice_id": "INV-AVIA-12345",
    "deposit_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "qr_code_url": "https://...",
    "amount": "95.50",
    "currency": "USDT_TRC20",
    "expires_at": "2026-04-25T22:00:00Z"
  },
  "ts": 1714063200
}

{
  "order_uuid": "550e8400-e29b-41d4-a716-446655440000",
  "currency": "USDT"
}

Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000

{
  "success": true,
  "data": {
    "order_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "status": "paid",
    "paid_at": "2026-04-25T20:05:00Z",
    "amount_charged": "95.50",
    "currency": "USDT",
    "balance_after": "1054.50",
    "ticket_status": "issued"           // issued / pending / failed
  },
  "ts": 1714063200
}

{
  "city": "7000546",                  // числовой id из /hotels/destination.
                                      // НЕ название города и НЕ hotel_city_id из /hotels/cities/search
  "check_in": "15.05.2026",           // строго dd.mm.yyyy — с точками, иначе 400
  "check_out": "20.05.2026",
  "adults": 2,                        // 1-6
  "children": [{ "child_age": 5 }],   // optional
  "lang": "ru"
}

{
  "success": true,
  "data": {
    "search": { "city": "7000546", "check_in": "15.05.2026", ... },
    "hotels": [
      {
        "id": "12345",
        "name": "Hotel Example",
        "stars": 4,
        "city": "Москва",
        "country": "Россия",
        "address": "...",
        "photos": [{ "url": "...", "thumb": "...", "is_default": true }],
        "rooms": [...],
        "hs": "search-hash-for-view"
      }
    ],
    "is_completed": true
  },
  "ts": 1714063200
}

{
  "city": "7000546",                  // числовой id из /hotels/destination
  "check_in": "15.05.2026",           // строго dd.mm.yyyy
  "check_out": "20.05.2026",
  "adults": 2,
  "children": [],
  "lang": "ru"
}

{
  "hotel_id": "12345",
  "check_in": "15-05-2026",           // dd-mm-yyyy
  "check_out": "20-05-2026",
  "adults": 2,
  "children": [{ "child_age": 5 }],
  "lang": "ru"
}

{
  "success": true,
  "data": {
    "hs": "eyJob3RlbF9pZCI6IjQxODUzMyIsImhzIjpudWxsLCJjaGVja19pbiI6...",
                                        // передавайте строку как есть в /check-rate и /book.
                                        // Это base64 параметров просмотра; при поиске по hotel_id
                                        // внутри лежит "hs": null — это нормально, не блокирует бронь
    "hotel": {
      "id": "12345",
      "name": "Hotel Example",
      "rooms": [
        {
          "id": "149e71dd-3257-43e3-8f06-9bb51208a270",  // UUID, внутренний ключ.
                                             // НЕ передавайте его в rate_id — провайдер его не знает
          "identifier": "418533..roomOnly..Улучшенный..19082026..835828f9..30,30",
                                             // ЭТО и есть идентификатор тарифа:
                                             // → recommendation_id в /select-room
                                             // → rate_id в /check-rate и /book
          "name": "Standard Double",
          "type": "DBL",
          "price": 12500.00,                 // в валюте провайдера
          "totalAmount": 12500.00,
          "mealType": "BB",                  // BB / HB / FB / AI
          "isFreeCancellation": true,
          "freeCancellationBefore": "...",
          "is_non_refundable": false,
          "cancelationRules": [...],         // → cancellation_policy_rules для /book
          "available_count": 3
        }
      ]
    }
  },
  "ts": 1714063200
}

{
  "hs": "rooms-search-hash",
  "hotel_id": "12345",
  "rate_id": "418533..roomOnly..Улучшенный..19082026..835828f9..30,30",   // rooms[].identifier
  "price": 12500.00,
  "is_not_refundable": false,
  "free_cancellation_before": "2026-05-13T12:00:00+00:00",
  "cancellation_policy_rules": [
    {
      "isPossible": true,
      "amount": 0,
      "UTCDateFrom": "2026-04-25T00:00:00+00:00",
      "UTCDateTo": "2026-05-13T12:00:00+00:00"
    }
  ],
  "lang": "ru"
}

{
  "success": true,
  "data": {
    "rate_id": "ROOM_ID",
    "check_price_changes": {
      "old": { "totalAmount": 12500, "price": 12500 },
      "new": { "totalAmount": 12500, "price": 12500 }
    },
    "cancellation_policy_rules_changes": {
      "old": [...],
      "new": [...]
    }
  },
  "ts": 1714063200
}

{
  "order_uuid": "550e8400-e29b-41d4-a716-446655440000",  // сгенерируйте UUID v4
  "hotel_id": "12345",
  "search_hash": "rooms-search-hash",   // optional, hs из /view
  "hotel_name": "Hotel Example",        // для отображения
  "lang": "ru"
}

{
  "success": true,
  "data": {
    "order_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "order_id": 78901,
    "status": "created",
    "datetime": "2026-04-25T20:00:00Z"
  },
  "ts": 1714063200
}

{
  "order_uuid": "550e8400-e29b-41d4-a716-446655440000",
  "view": {
    "hotel_id": "12345",
    "check_in": "15-05-2026",
    "check_out": "20-05-2026",
    "adults": 2,
    "children": [],
    "lang": "ru"
  }
}

{
  "success": true,
  "data": {
    "order": { "order_uuid": "...", "order_id": 78901, "status": "created" },
    "view": { /* такой же формат, как у /search/view */ }
  },
  "ts": 1714063200
}

{
  "order_uuid": "550e8400-e29b-41d4-a716-446655440000",
  "recommendation_id": "ROOM_IDENTIFIER",   // identifier из /view → rooms[].identifier
  "payload": "{\"...full room JSON from /view...\"}"   // payload номера, как пришёл из /view
}

{
  "success": true,
  "data": {
    "order_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "status": "room_selected"
  },
  "ts": 1714063200
}

{
  "order_uuid": "550e8400-e29b-41d4-a716-446655440000",
  "hotel_id": "12345",
  "search_hash": "rooms-search-hash",
  "hotel_name": "Hotel Example",
  "lang": "ru",
  "recommendation_id": "ROOM_IDENTIFIER",
  "payload": "{\"...room JSON...\"}"
}

{
  "success": true,
  "data": {
    "order_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "order_id": 78901,
    "status": "room_selected",
    "myagent_price": 12500.00,
    "alfabit_price": 13125.00            // включая нашу маржу
  },
  "ts": 1714063200
}

{
  "order_uuid": "550e8400-e29b-41d4-a716-446655440000",
  "client_email": "user@example.com",
  "client_phone": "+79001234567",
  "guests": [
    { "first_name": "Ivan", "last_name": "Ivanov", "type": "adt" },
    { "first_name": "Anna", "last_name": "Ivanova", "type": "chd", "age": 5 }  // age обязателен для chd/inf
  ],
  "hs": "rooms-search-hash",
  "hotel_id": "12345",
  "hotel_name": "Hotel Example",
  "rate_id": "418533..roomOnly..Улучшенный..19082026..835828f9..30,30",
                                       // тот же rooms[].identifier, что в /select-room и /check-rate
  "price": 12500.00,                   // из /check-rate
  "is_not_refundable": false,
  "free_cancellation_before": "2026-05-13T12:00:00+00:00",
  "cancellation_policy_rules": [        // из /check-rate
    {
      "isPossible": true,
      "amount": 0,
      "UTCDateFrom": "2026-04-25T00:00:00+00:00",
      "UTCDateTo": "2026-05-13T12:00:00+00:00"
    }
  ],
  "lang": "ru"
}

Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000

{
  "success": true,
  "data": {
    "order_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "billing_number": "BN-2026-78901",
    "status": "booked"               // booked / failed
  },
  "ts": 1714063200
}

{
  "order_uuid": "550e8400-e29b-41d4-a716-446655440000",
  "currency_in_code": "USDT_TRC20",   // USDT_TRC20 / BTC / ETH / RUB / ...
  "use_miles": false,
  "miles_to_redeem": null              // если use_miles=true
}

{
  "success": true,
  "data": {
    "invoice_id": "INV-12345",
    "order_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "currency": "USDT_TRC20",
    "amount": "100.00",
    "deposit_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "qr_code_url": "https://...",
    "expires_at": "2026-04-25T21:00:00Z",
    "status": "pending"
  },
  "ts": 1714063200
}

{
  "order_uuid": "550e8400-e29b-41d4-a716-446655440000",
  "currency": "USDT",                  // валюта баланса
  "use_miles": false,
  "miles_to_redeem": null
}

Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000

{
  "success": true,
  "data": {
    "order_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "status": "paid",
    "paid_at": "2026-04-25T20:05:00Z",
    "amount_charged": "100.00",
    "currency": "USDT",
    "balance_after": "1150.00"
  },
  "ts": 1714063200
}

currency=USDT     // USDT / BTC / ETH / RUB

{
  "success": true,
  "data": {
    "user_id": "sso-id-of-user",
    "currency": "USDT",
    "balance": "1250.00"
  },
  "ts": 1714063200
}

{
  "success": true,
  "data": {
    "order_id": 78901,
    "status": "paid",
    "expire": "2026-04-25T21:00:00Z",
    "guests": [
      { "first_name": "Ivan", "last_name": "Ivanov", "type": "adt" },
      { "first_name": "Anna", "last_name": "Ivanova", "type": "chd", "age": 5 }
    ],
    "hotel": { /* такой же формат, как у /search/view */ },
    "price": 12500.00,
    "billing_number": "BN-2026-78901",
    "receipt": "https://...voucher.pdf",
    "client_email": "user@example.com"
  },
  "ts": 1714063200
}

{
  "success": true,
  "data": {
    "order_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "status": "paid",
    "updated_at": "2026-04-25T20:05:00Z"
  },
  "ts": 1714063200
}

{
  "reason": "hotel_other_reason",        // optional
  "reason_comment": "Изменились планы"   // обязателен только если reason='hotel_other_reason'
}

{
  "success": true,
  "data": {
    "order_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "status": "cancelled",
    "refund_amount": "12500.00",         // если был paid
    "refund_currency": "RUB"
  },
  "ts": 1714063200
}

{
  "url": "https://your-domain.com/webhook",
  "events": [
    "invoice.paid",
    "card.transaction",
    "service_payment.confirmed",
    "travel.avia_order.paid"
  ]
}

{
  "success": true,
  "data": [
    {
      "symbol": "USDT",
      "bch_code": "TRX",
      "withdraw_amount_decimals": "6",
      "min_withdraw_amount": "3",
      "max_withdraw_amount": "150000",
      "withdraw_service_fee": "2.5",
      "is_withdraw_active": true,
      "is_deposit_active": true,
      "min_deposit_amount": "1",
      "is_memo_tag_required": false,
      "net_confirmations": 20
    },
    {
      "symbol": "USDT",
      "bch_code": "BSC",
      "withdraw_amount_decimals": "8",
      "min_withdraw_amount": "10",
      "max_withdraw_amount": "150000",
      "withdraw_service_fee": "1.2",
      "is_withdraw_active": true
    }
  ],
  "ts": 1706000000
}

{
  "success": true,
  "data": [
    { "symbol": "USDT", "rate_usdt": "1" },
    { "symbol": "BTC", "rate_usdt": "78635.6" },
    { "symbol": "ETH", "rate_usdt": "2470.64" },
    { "symbol": "TRX", "rate_usdt": "0.3438" }
  ],
  "ts": 1706000000
}

{
  "tariff": "standard",
  "fees": {
    "withdraw_btc": "0.0001",
    "withdraw_usdt_trc20": "1",
    "exchange_fee": "0.1%",
    "card_topup_fee": "2%"
  }
}

{
  "success": true,
  "data": {
    "page": 1,
    "limit": 50,
    "count": 156,
    "results": [
      {
        "source": "fiat",
        "uid": "0f3c1a7e-1b9d-4f2a-9c11-6a0d5e7b8c34",
        "type": "deposit",
        "symbol": "RUB",
        "amount": "5000.00",
        "status_for_client": "success",
        "is_final_state": true,
        "method": null,
        "fee": "0.0",
        "sender_id": 7504,
        "receiver_id": 9001,
        "user_comment": "order-12345",
        "sender": { "email": "client@example.com", "telegram_username": null },
        "receiver": { "email": "shop@example.com", "telegram_username": null },
        "created_at": 1753812345.0
      },
      {
        "source": "crypto",
        "uid": "a1b2c3d4-...",
        "type": "deposit",
        "symbol": "USDT",
        "amount": "500.00",
        "status_for_client": "success",
        "is_final_state": true,
        "method": "email",
        "created_at": 1753810000.0
      }
    ]
  },
  "ts": 1706000000
}

{
  "success": true,
  "data": {
    "source": "fiat",
    "uid": "0f3c1a7e-1b9d-4f2a-9c11-6a0d5e7b8c34",
    "type": "deposit",
    "symbol": "RUB",
    "amount": "5000.00",
    "status_for_client": "success",
    "is_final_state": true,
    "fee": "0.0",
    "sender_id": 7504,
    "receiver_id": 9001,
    "user_comment": "order-12345",
    "created_at": 1753812345.0
  },
  "ts": 1706000000
}