悠悠楠杉
易支付对接易商户完整版:从接口配置到回调核对
易支付对接易商户,表面上是填写商户信息和接口地址,实际要让两套系统对同一笔订单达成一致:谁创建订单,谁发起收款,付款结果由谁通知,异常订单由谁处理。不同版本或部署方式的字段名称、签名规则可能不同,动手前应以当前使用的接口文档和后台配置为准。
配置页面已经填完,仍不确定请求往哪里发
先确认对接方向。若易商户作为收款接口,易支付发起支付请求,就要从易商户取得对应的商户标识、接口地址和签名所需凭据;若两者承担的角色相反,配置位置和请求方向也会随之改变。只看到“对接成功”的页面提示,还不能判断整条支付链路已经可用。
核对一笔测试订单的发起记录会更直接:订单号由哪一端生成,请求金额如何传递,支付页面返回后落到哪个地址。订单号尤其不能随意重用。两个系统各自有内部编号时,应保存对应关系,否则回调到达后,接收端可能找不到原订单。金额也要按接口文档约定的单位和格式传递,避免一端按元、另一端按分处理。
密钥只放在服务端配置中,不写进前端页面或公开的调试截图。签名失败时,先核对参与签名的字段、排序及编码规则,不要为了让请求通过而关闭验签;规则本身要从当前接口文档确认,不能直接套用另一套易支付程序的示例代码。
用户已付款,易支付订单仍显示未支付
假设有这样一种情况:易支付能够跳转到易商户收银页,用户完成付款后也回到了网站,但原订单一直停留在“未支付”。排查容易卡在返回页面上,反复修改跳转地址。实际上,用户浏览器的返回动作和服务端支付通知通常是两条路径;用户关掉页面,或返回页面加载失败,都不该单独决定订单状态。
这时保留该笔测试订单在两端的编号,核对易商户侧记录的交易状态,以及易支付服务端有没有收到异步通知。如果通知根本没有到达,检查后台填写的通知地址能否从外部访问、路径是否指向实际处理程序。通知已到达却未更新订单,则查看接收端记录的验签结果,以及通知中的订单号、金额能否匹配原订单。
处理时只围绕这笔订单改动,避免同时更换密钥、通知地址和订单生成方式。若发现接收端返回失败,修正后再用新订单测试通知;旧订单能否补发通知或人工核对,取决于所用平台提供的能力。付款状态尚未核实前,不因用户截图就直接把订单改成已支付。
回调恢复后,还有哪些订单要核对
测试订单显示成功后,继续看重复通知如何处理。支付平台可能因未收到预期响应而再次发送同一笔结果;接收端应识别已处理订单,避免重复发货或重复增加余额。支付成功页可以展示结果,但交付动作仍以服务端核实后的订单状态为依据。
上线前保留少量可定位问题的记录:本地订单号、对端交易号、请求与通知时间、处理结果。日志中的密钥及敏感信息要遮蔽。正式环境与测试环境的地址、凭据分别确认,不把测试时可用的配置直接复制过去。最后用新订单走一遍发起支付、完成付款和异步通知,并到两端后台核对同一笔交易;对仍未更新的旧订单,按编号逐笔查明状态后再处理。

