完整使用流程

第三方系统接入后的完整使用流程如下：

1. 获取用户 Token

   • 调用 /thirdPartyLogin 接口，使用商户私钥签名获取用户 Token

   • 后续所有 API 调用都需要在请求头中携带此 Token

2. 查询登录态

   • 调用 /checkLogin 接口验证 Token 是否有效

   • 如果 Token 失效，需要重新调用 /thirdPartyLogin 获取新 Token

3. 获取卡片列表

   • 调用 /merchant/cards 接口获取商户可以申请的卡片列表

   • 支持按关键字搜索、筛选条件过滤、排序等功能

4. 获取卡片类型配置

   • 调用 /cards/getCardbinSettings 接口获取指定发卡商支持的卡片类型

   • 了解卡片类型、支持的国家、币种、费用、限额等信息

5. 检查卡片是否可以申请

   • 调用 /cards/checkCanApply 接口检查指定卡片是否可以申请

   • 获取申请条件、可绑定卡片数量、申请金额等信息

6. 申请卡片（如需要）

   • 调用 /cards/binding 接口申请/绑定卡片

   • 如果卡片支持 API 对接，会直接绑定并返回卡片信息

7. 查询开卡/充值汇率

   • 调用 /cards/feeQuote 接口查询开卡或充值的汇率及手续费信息

   • 用于向用户展示费用明细

8. 预充值

   • 调用 /charge/preCharge 接口进行预充值

   • 开卡场景：获取 order_id，需要提供 card_issue_info（如果没有 card_binding_id）

   • 充值场景：获取预充值结果

9. 获取充值地址和二维码

   • 调用 /charge/getChargeQrCode 接口获取充值地址和二维码

   • 返回充值地址、最小充值金额、过期时间和二维码（Base64编码）

10. 用户转账操作

    • 方式一：通过二维码充值

      • 用户扫描二维码，向充值地址转账

      • 系统自动处理充值并回调商户

    • 方式二：插件钱包转账（开卡）

      • 用户通过插件钱包（如MetaMask）向充值地址转账

      • 调用 /cards/uploadTransaction 接口上传交易 Hash

      • 调用 /cards/getTransactionByHash 接口查询开卡状态

    • 方式三：插件钱包转账（充值）

      • 用户通过插件钱包向充值地址转账

      • 调用 /wallet/uploadTransaction 接口上传交易 Hash

      • 调用 /wallet/getTransactionByHash 接口查询充值状态

11. 查询订单详情

    • 调用 /getRecordDetail 接口根据订单号查询交易详情

    • 获取开卡、充值、支付、提现等交易的详细信息

12. 查询交易记录

    • 调用 /userTrans 接口查询所有交易记录（支持分页和筛选）

    • 调用 /userTransRecord 接口查询单条交易记录详情