{
  "revision": "2026-09-19.3",
  "api_version": "1.34.0",
  "manual": "https://docs.luniumpay.com/zh/manual#incidentes",
  "authority": "用于只读排查与对账，不授权财务写入、费率更改或凭证轮换。",
  "rules": [
    "发送财务请求前，持久化保存操作意图及 external_id。",
    "结果未知不等于失败。切勿仅为消除告警而创建新的财务操作意图。",
    "按项目及环境隔离，尽量减少个人数据。",
    "读取当前通道最低金额、费用与可用性。不得擅自更换收款人、资产或网络。"
  ],
  "cases": [
    {
      "id": "paid_crypto_pending",
      "read": [
        "GET /cashin/{cashin_id}/status"
      ],
      "success": "status == paid AND settlement_status == sent",
      "action": "跟踪原操作；出现 failed、incerto 或持续无进展时升级处理，不要发起第二次转账。"
    },
    {
      "id": "custody_unavailable",
      "read": [
        "GET /cashin/{cashin_id}/status",
        "GET /saldo?customer_ref={customer_ref}"
      ],
      "action": "核对同一客户范围、暂不可用与可用余额，以及返回的释放条件。总余额不等于可提现余额。"
    },
    {
      "id": "webhook_missing",
      "read": [
        "GET /webhooks/deliveries",
        "原操作的权威 GET 状态查询"
      ],
      "action": "独立核对财务状态；修复接收端后再重试既有投递。队列中没有事件不能证明付款失败。"
    },
    {
      "id": "response_lost",
      "read": [
        "GET /cashin/charges?external_id={external_id}",
        "GET /cash-outs?external_id={external_id}",
        "GET /payouts?external_id={external_id}"
      ],
      "action": "选择与流程匹配的列表接口，保留原请求体与标识符，使用退避进行对账。暂时查不到记录不能证明请求被拒绝。"
    },
    {
      "id": "route_unavailable",
      "read": [
        "GET /cashin/catalog",
        "GET /catalog"
      ],
      "action": "选择正确目录。付款前应请求已授权的新选择；付款后保留原操作并升级处理。"
    },
    {
      "id": "commission_missing",
      "read": [
        "GET /cashin/{cashin_id}/status",
        "GET /comissao",
        "GET /comissao/extrato"
      ],
      "action": "核对记录的收款费用、结算状态及后续记账。配置变更不追溯修改既有交易。"
    },
    {
      "id": "commission_withdrawal_response_lost",
      "read": [
        "GET /cashin/charges?external_id={external_id}",
        "GET /comissao",
        "GET /cashin/{cashin_id}/status"
      ],
      "action": "时间间隔检查先于引用标识查询，因此即使之前已接受，重试仍可能返回 429。再次请求前先对账。"
    }
  ],
  "escalation": {
    "contacts": [
      "https://t.me/luniumb2b",
      "https://t.me/luniumb2c"
    ],
    "include": [
      "environment",
      "operation_id",
      "external_id",
      "timestamp_with_timezone",
      "http_status",
      "erro",
      "acao",
      "request_id_if_present",
      "last_status",
      "webhook_event_id_if_relevant"
    ],
    "exclude": [
      "api_key",
      "webhook_secret",
      "monitor_url",
      "full_taxpayer_id",
      "unsanitized_customer_payload"
    ]
  },
  "capability_boundary": {
    "documented_access": "私有只读监控与公开 OpenAPI 接口",
    "multi_destination_webhook": "在能力写入生产规范且完成验证之前，不应假定其可用",
    "source_of_truth": [
      "https://api.luniumpay.com/openapi.json",
      "https://docs.luniumpay.com/zh/manual-contract.json"
    ],
    "snapshot_facts": "注明日期的测量值属于历史记录，不代表当前可用性或承诺的 SLA"
  }
}