Skip to content

接入流程 ​

1. 准备对接信息 ​

由我方运营提供:

信息说明
合作方编码 partnerCode请求头 X-Partner-Code 和下单参数里都要带
接口密钥 appSecret用于请求签名和验证通知签名,单独发送,请妥善保管,不要写在前端或提交到代码仓库
已开通的支付渠道下单参数 channelCode 的可选值
测试、生产接口地址本文档中写作 https://xxx.xxx.xxx

需要你方提供:

信息说明
服务器出口 IP我方会把这些 IP 加入白名单,不在白名单内的请求会被拒绝(错误码 2155)
技术联系人出现问题时联系

2. 测试环境联调 ​

  1. 按 签名规则 实现签名,先用文档里的测试数据核对你的签名结果是否一致。
  2. 调用 下单 接口,拿到支付参数调起支付。
  3. 实现 支付结果通知 接收接口:验签、按 payNo 幂等处理、返回 success。
  4. 用 查单 接口核对订单状态。

3. 上线 ​

测试通过后,我方开通生产环境的编码和密钥(测试和生产的密钥不同),把接口地址切换到生产域名即可。

密钥泄露怎么办

请立即联系我方重置密钥。重置后旧密钥马上失效,需要尽快换上新密钥,否则所有请求都会签名失败。