悠悠楠杉
易支付对接接口怎么用?从发起付款到订单到账
易支付对接接口,是让业务系统向支付服务发起订单,再接收支付结果。接入时,收银台能打开只完成了一部分;用户付款后,本地订单还要经过可信确认,才能发货或开通服务。
提交订单前,确认文档对应哪个接口
“易支付”这个名称下存在不同实现,网上找到的示例代码未必适用于你正在使用的平台。拿到商户后台资料后,核对接口地址和文档版本,确认平台采用跳转收银台还是服务端创建订单的方式。
采用页面跳转的接口,会让用户进入支付页面;服务端下单接口则可能返回付款链接或二维码。两种方式的请求结构可能不同,不能直接替换地址就继续使用。
商户密钥保存在服务端,不放进网页脚本或前端配置。用户点击付款时,由后端读取商品价格、生成本地订单,再构造支付请求。浏览器传来的金额不能直接作为收款依据,否则修改请求就可能改变订单价格。
签名负责校验请求是否被篡改。部分兼容接口采用参数排序、拼接后计算摘要的方式,但空值处理、编码方式以及密钥参与计算的位置,以当前平台文档为准。遇到“签名错误”,保留脱敏后的待签名字符串,与官方示例核对;密钥不要写进日志,也不要提交到公开仓库。
用户付了款,网站仍显示待支付
支付接口对接里,同步跳转和异步通知承担不同作用。同步跳转负责把用户带回网站,异步通知由支付平台请求你的后端,用来传递订单结果。用户关闭付款页面,仍可能已经完成支付;回到成功页面,也不能直接据此发货。
假设有这样一种情况:一个售卖数字内容的网站接入易支付后,用户完成付款并返回订单页,但内容仍未解锁。本地订单停留在待支付状态,开发者最初怀疑是返回页面没有刷新。
排查沿着异步通知地址展开:该地址套用了网站的登录校验,支付平台访问时被转到登录页,通知没有进入订单处理代码。这个示例中的处理方向,是让指定回调路由免于用户登录校验,同时保留支付回调验签。开放回调入口不代表信任所有请求。
处理代码收到通知后,核对签名与支付成功状态,再比对本地订单的金额和商户归属。金额使用固定精度的小数或整数分处理,避免浮点误差干扰比较。校验通过后,才把待支付订单转为已支付,并按文档要求返回确认内容。
这条处理路径仍有现实限制:平台可能重复发送通知,网站也可能在更新订单时短暂故障。订单状态更新要带条件,已支付订单再次收到同一通知时,不重复发放内容。若发货属于独立任务,记录任务状态,失败后重试该任务。
开发者调整回调路由后,下一笔测试订单继续保留脱敏通知日志。此前未更新的订单,通过平台查询接口或后台交易记录核对后补处理;在交易未核实前,暂不解锁。
准备上线时,把付款闭环测完整
易支付接口的测试不能停在“能打开收银台”。记录一次测试订单从本地创建到收到通知的变化,并测试重复通知,检查服务有没有重复发放。
回调地址使用公网可访问的 HTTPS 地址。服务器的访问控制不能依赖浏览器登录态;若平台提供来源校验机制,按文档配置,仍保留签名验证。后台显示支付成功、本地却没有收到通知时,保留订单号和脱敏日志,核对通知记录;通过查单接口补偿,也要验证响应并匹配本地订单。
上线前还要确认服务商支持你的业务类型,并核对结算安排。随后补齐当前接口版本的签名规则与回调成功响应格式,用测试订单验证付款后状态能够更新,再接入实际业务流量。

