Im Wallet

常用接口

// 冻结余额
ZhOtcWalletApi.frozenBalance(FrozenBalanceReq req)

// 解冻余额
ZhOtcWalletApi.unfrozenBalance(UnfrozenBalanceReq req)

// 会员调账 (加币/扣币)
ZhOtcWalletApi.adjustMemberAmount(AdjustMemberAmountReq req)

// 查询余额
UserWalletApi.getUserBalance(UserBalanceReq req)

ZHOTC 对接

调用流程

业务服务 → ZhOtcService → ZhOtcWalletApi → ZHOTC系统
                ↓
           失败记录到 zh_otc_error_log
                ↓
           定时任务补偿重试

核心类定位

openchat-wallet-biz/
└── service/zhotc/
    ├── otc/
    │   ├── ZhOtcService.java       # 业务封装
    │   └── ZhOtcWalletApi.java     # HTTP调用
    └── etx/
        ├── ZhOtcFrozenBalanceCompensateService.java
        ├── ZhOtcUnfrozenBalanceCompensateService.java
        └── ZhOtcAdjustMemberAmountCompensateService.java

补偿机制

• 失败自动记录到 zh_otc_error_log 表
• 最大重试次数: 5 次 (zhOtc.error.maxRetry)
• 补偿类型: 冻结/解冻/调账

常见业务场景

1. 发红包冻结

1. 调用 frozenBalance 冻结发送者余额
2. 返回 frozeFlowNo (冻结流水号)
3. 红包被领取 → adjustMemberAmount 调账给领取者
4. 红包过期 → unfrozenBalance 解冻退回

2. 交易完成调账

1. 买家付款确认
2. 卖家放币 → adjustMemberAmount (卖家扣币)
3. 买家到账 → adjustMemberAmount (买家加币)
4. 扣除手续费

3. 聊天转账

1. 转出方冻结 (frozenBalance)
2. 对方收款 → frozenTransferAmount (冻结转账)
3. 对方不收 → unfrozenBalance (解冻退回)

账变类型枚举

详见 coin-record-enum.md

ZHOTC API 详情

详见 zhotc-api.md

问题排查

余额不对

1. 查 user_coin 当前余额
2. 查 user_coin_record 最近账变
3. 核对 ZHOTC 侧余额

冻结/解冻失败

1. 查 zh_otc_error_log 错误日志
2. 检查 frozeFlowNo 是否正确
3. 检查 ZHOTC 返回的错误信息

调账未到账

1. 确认 adjustMemberAmount 是否成功
2. 检查 isUp 参数 (true=加币, false=扣币)
3. 查补偿任务是否在重试