开始开发前,先确认商户账号、接口版本、签名信息和支付域名状态。配置完成后,再按接口接入教程发起测试订单。
一、准备好接入资料
| 资料 | 用途 | 检查重点 |
|---|---|---|
| 商户ID | 标识发起支付请求的商户 | 从商户中心的“API信息”页查看,按当前接口文档填写。 |
| 签名凭证 | 服务端对请求签名、验证通知 | 先确认接口版本和签名算法;新版RSA与旧版MD5的参数规则不能混用。 |
| 支付域名 | 用于创建支付订单的网站域名 | 如果平台要求域名授权,需在商户中心提交并等待审核通过。 |
| 通知和返回地址 | 分别接收服务端通知、引导付款人返回网站 | 通知地址应由商户服务端接收;返回页面不能替代支付结果核验。 |
二、查看商户ID和签名信息
- 登录商户中心 → 个人资料 → API信息。
- 按正在使用的接口版本,确认商户ID及对应的签名信息;不要把新版和旧版的密钥、签名方式交叉使用。
- 商户私钥只保存在自己的服务端。API信息页会提示私钥的查看和保存规则;如页面说明私钥无法再次查看,关闭窗口前先安全备份。不要把私钥放进网页前端、公开代码仓库或工单截图。
不要把商户ID、私钥或完整签名发给他人排错。排查时只提供已脱敏的请求参数、时间和返回信息。
三、提交并确认授权支付域名
- 登录商户中心,打开“授权域名”。
- 添加实际发起支付的网站域名,按页面提示填写域名,不要把完整支付链接、路径或订单号当作域名提交。
- 检查域名状态:显示“正常”后再用该域名创建支付订单;“审核中”或“拒绝”时,先按后台提示处理。
域名授权针对商户发起支付时使用的网站域名。商户的通知接收地址是另一项设置,应确保其域名、HTTPS证书和服务端路由可用。
四、区分通知地址和返回地址
- notify_url:平台服务器向商户服务器发送支付结果通知的地址。接收后应按文档验签、核对订单号与金额,并安全更新本地订单。
- return_url:用户完成支付流程后浏览器返回商户网站的地址。浏览器跳转只用于展示结果,不能单独作为“已付款”的依据。
这两个地址通常随下单请求提交,具体字段和签名方法以统一下单接口及支付结果通知文档为准。
五、上线前逐项核对
- 商户ID、接口版本和签名算法与代码一致。
- 发起支付的域名已获授权,状态正常。
- 订单号唯一,金额格式符合接口要求。
- 通知地址可由公网访问,且服务端能够验签和核对金额。
- 通知处理支持重复调用;通知暂未到达时可按订单查询接口核对状态。
- 先在可控订单上验证下单、通知、查单和失败处理,再投入正式业务。