钱包对接流程说明
本文档用于说明 平台与钱包系统的对接流程，覆盖：
- ✅ 钱包预创建 / 登录跳转
- ✅ 代收订单创建与支付跳转
- ✅ 代付订单创建与处理跳转
- ✅ 余额不足时的购买引
- ✅ 一张判断流程图
1. 钱包注册与创建（预创建接口）
1.1 调用预创建接口
访问预创建接口：
POST /api/user/precreate
1.2 判断钱包是否已创建
-
✅ 如果返回了
wallet- 说明钱包已创建
- 可直接进入后续「访问钱包 / 代收 / 代付」
-
❌ 如果未返回
wallet- 说明用户尚未注册钱包
- 直接访问
loginUrl返回的链接，跳转到钱包即可完成注册/绑定，后续均是无感登录
2. 代收订单（Collect）对接流程
2.1 创建代收订单
调用代收订单同步接口：
POST /api/order/createwait
2.2 拼接代收支付地址
将 createwait 返回的订单号 与 precreate 返回的 token / uid 拼接为 quick-pay 链接：
示例：
https://web.bgswift.com/quick-pay?orderno=<orderno>&token=123&uid=123
访问该链接后：
- 会自动跳转到钱包支付界面
- 用户按页面引导完成支付
3. 代收，用户余额不足时的处理
在引导用户进入支付前，建议游戏平台做一次余额判断，可以有效的提高代收成功率：
- ✅ 余额足够 → 走 quick-pay（代收支付页）
- ❌ 余额不足 → 跳转钱包购买代币流程
3.1 跳转购买页（Quick Login + type=buy）
直接访问 预创建接口 返回的 loginUrl，并拼接参数 type=buy
示例：
https://web.bgpayweb.com/quicklogin?token=1b67a6f55369415eb47ccd14585c950d&uid=61jmvOM9_5331514817&type=buy
4. 代收，检测到用户未注册钱包时的处理（首次注册）
如果用户尚未注册钱包：
- 直接访问 precreate 返回的
loginUrl - 系统会引导用户完成注册/登录
- 注册完成后再继续代收/代付流程
5. 代付订单对接流程
接口路径/参数如果与你们实际不同，你只需要替换这一小段即可（正文结构不需要改）。
5.1 创建代付订单
- 调用代付订单创建接口（示例占位）：
POST /api/paywallet/create
按照接口文档参数，请求即可，系统自动验证代付订单