转帐钱包流程图

完整的业务流程图，帮助您理解转帐钱包模式下各个接口的调用时序和业务逻辑。若代理为单一钱包模式，请改参考单一钱包流程图。

⚠️ 不提供「游戏内转帐」

QK 棋牌不提供游戏内转帐（即时通知运营商上下分）机制。转帐钱包模式下，上下分皆由运营商主动呼叫下方的上分 / 下分接口完成，QK 棋牌不会针对上下分结果主动回调运营商，也没有自动重试机制——若请求超时未收到响应，请改用查询订单接口(s:4)确认结果，切勿以相同 orderid 重复发起请求。若想让 QK 棋牌在玩家离开游戏时主动提醒运营商下分，可搭配离线通知(s:11)，但该通知与上下分结果无关，仅为最佳努力送达的提示。

👤 登入平台流程

🆚 与单一钱包登入流程的差异

登入流程与单一钱包流程图共用同一支游戏登入接口(s:0)，差异在于：

• 转帐钱包（本页）：登入时可额外带入 money 参数直接上分（详见下方上分流程）；余额已在登入时上分到 QK 棋牌内部钱包，游戏中的现金增减由 QK 直接处理，运营商不需要实作单一钱包文档中查询余额/下注/取消下注/返还余额等接口。
• 单一钱包：money 参数不需要、也不会生效；QK 棋牌与运营商共用同一份余额，每次下注/派彩会即时呼叫运营商依单一钱包文档实作的接口查询/异动余额。

💰 上分流程 (登入带 money 参数 / s:2)

📌 上分注意事项

为避免「运营商系统余额」被重复扣款或与 QK 棋牌余额不同步，建议运营商依下列顺序处理上分：

1. 运营商系统扣款失败 → 取消本次上分，不要再呼叫 QK 棋牌
2. 运营商系统扣款成功 → 才呼叫 QK 棋牌上分接口 (登入带 money 参数 / s:2)
3. QK 棋牌接口返回失败 (code≠0) → 归还刚才从运营商系统扣除的金额
4. 网络超时未收到响应 → 间隔一段时间（建议 2 分钟）后改呼叫查询订单接口(s:4)确认结果，切勿以相同 orderid 重新呼叫上分

💵 下分流程 (s:3)

📌 下分注意事项

• 为避免「还没下分成功的分数被提前花用」，运营商应先呼叫 QK 棋牌下分接口 (s:3)，确认下分成功后再更新运营商系统余额，切勿先加回运营商余额再等 QK 棋牌回应
• 运营商可用查询可下分接口(s:1)，随时查询玩家目前的可下分余额

🔍 查询订单确认流程 (s:4)

转帐钱包模式没有 QK 主动重试的机制，上分 / 下分请求若超时未收到响应，请依下列流程用查询订单接口确认结果，而不要直接以相同 orderid 重新发起请求。

🔔 离线通知（搭配转帐钱包模式）

转帐钱包模式可搭配玩家离线登出(s:11)：玩家离开游戏时 QK 棋牌主动通知运营商，运营商收到后可自行决定何时下分（搭配查询玩家总分(s:7)与下分(s:3)）。

⚠️ 最佳努力送达，非即时通知

离线通知为最佳努力送达（best-effort），QK 棋牌不会对失败的通知进行重试；若运营商未配置渠道回调地址（channel_host），QK 棋牌也不会发送此通知。此机制仅用于提示运营商可以下分，实际余额仍须以查询玩家总分(s:7)为准，详见通知回调 API 文档。