集成指南

商户提交申请服务资料给 BoC

• 商户公钥
• 商户测试场的固定 IP（可申请多个）
• 手机号码和电子邮件（用于测试APP开户）

具体参考：申請服務需提交的資料.docx

开户后给回商户的资料

• user_confirm_key
• secret_code

商户对接 VMP 用到的资料

• user_confirm_key
• secret_code
• BoC 公钥
• 测试 APP 以及登录账号

支付流程

商户 call BoC Pay APP

步骤：

1. 通过 VMP API 下单获取支付链接。查看：VMP接口文档
2. 通过 link 方式 call BoC Pay。参考：BOCPay（App-call-App）EWA以及APP端對接方案.docx

使用 BoC Pay 测试场 APP 支付

• 只有申请了固定 IP 才能登录使用测试 APP
• 测试场分 F 场 和 K 场，测试 APP 也分 F 场 和 K 场的 APP，测试场与测试 APP 要对应使用
• 测试场会在 F 场 和 K 场之间切换，切换时间表由 BoC 侧管理，因此测试支付前，需要确认测试场以及时间表，合理安排测试
• 测试 APP 设定默认打开链接
  • F 场设为：shawn-dev.wallyt.net
  • K 场设为：mbaapp.ftcwifi.com

比如：

商户验签 BoC 跳回商户 APP 的请求参数

APP 场景下，商户 APP 需要自行验签 BoC 的请求参数，步骤如下：

1. 整个请求参数url解码
2. 请求参数只需使用 SHA256withRSA 验证签名即可

比如：

请求字串如下：

merchantlink?charset=utf-8&content={"err_msg":"","out_trade_no":"0123123121231312","result_code":"00","transaction_id":"012312312123123"}&format=json&timestamp=2020-08-25 20:26:31&version=1.0signature=xxxxxxxx

用 Boc 公钥对整个字串（去除 signature）用 SHA256withRSA 验证签名

SHA256withRSA(merchantlink?charset=utf-8&content={"err_msg":"","out_trade_no":"0123123121231312","result_code":"00","transaction_id":"012312312123123"}&format=json&timestamp=2020-08-25 20:26:31&version=1.0)

注意

• callback 返回的结果不能作为支付的最终支付结果，商户需要查询支付结果
• BoC 跳回商户 APP 的请求参数中的 out_trade_no 对应 VMP 参数中的 eft_trade_no
• BoC 跳回商户 APP 的请求参数中的 transaction_id 并不对应 VMP 参数中的 transaction_id 或者 trade_no

错误码

具体查看：错误码