深色模式
接入流程
1. 准备对接信息
由我方运营提供:
| 信息 | 说明 |
|---|---|
合作方编码 partnerCode | 请求头 X-Partner-Code 和下单参数里都要带 |
接口密钥 appSecret | 用于请求签名和验证通知签名,单独发送,请妥善保管,不要写在前端或提交到代码仓库 |
| 已开通的支付渠道 | 下单参数 channelCode 的可选值 |
| 测试、生产接口地址 | 本文档中写作 https://xxx.xxx.xxx |
需要你方提供:
| 信息 | 说明 |
|---|---|
| 服务器出口 IP | 我方会把这些 IP 加入白名单,不在白名单内的请求会被拒绝(错误码 2155) |
| 技术联系人 | 出现问题时联系 |
2. 测试环境联调
- 按 签名规则 实现签名,先用文档里的测试数据核对你的签名结果是否一致。
- 调用 下单 接口,拿到支付参数调起支付。
- 实现 支付结果通知 接收接口:验签、按
payNo幂等处理、返回success。 - 用 查单 接口核对订单状态。
3. 上线
测试通过后,我方开通生产环境的编码和密钥(测试和生产的密钥不同),把接口地址切换到生产域名即可。
密钥泄露怎么办
请立即联系我方重置密钥。重置后旧密钥马上失效,需要尽快换上新密钥,否则所有请求都会签名失败。