悠悠楠杉
易支付对接教程:从下单请求到支付回调
易支付对接并不是把收款链接放进页面就结束。用户跳到收银台并完成付款后,商户系统还要收到支付结果,才能更新订单、发放商品或开通服务。不同易支付服务商的字段名、签名规则和接口地址可能不同,动手前以当前服务商的接口文档为准,不要直接套用另一套平台的示例代码。
下单页面能打开,订单却没有付款记录
接入时,网站一般先在自己的数据库里创建一笔待支付订单,再由服务端按接口文档提交商户号、订单号、金额等信息。签名所用的密钥留在服务端;把它写进前端页面或小程序代码,访问页面的人就可能取得密钥。
这里容易混淆两个地址:用户付款后返回的页面地址,以及支付平台向商户服务器发送结果的异步通知地址。前者影响用户看到什么页面,后者关系到站内订单何时变为已支付。用户关掉浏览器、网络中断,都可能让返回页面无法正常打开;反过来,浏览器到了“支付完成”页,也不能单凭页面跳转发货。
下单阶段还要让商户订单号在本系统内保持唯一。若重试请求产生了新订单号,后来排查回调时,就可能对不上用户最初看到的那笔订单。开发时保留请求时间、订单号和接口响应,但不要在日志里明文记录密钥。
支付成功了,异步通知没有到达
假设一个网站已能正常跳转收银台,测试付款后,支付平台显示交易完成,网站订单仍停在“待支付”。处理这类情况,先在服务商后台查该笔交易的通知记录,再核对商户端的访问日志。若没有请求到达,检查通知地址能否从公网访问,以及服务器是否把请求挡在登录校验或防火墙之外。只在本机浏览器打开通知地址,不能证明支付平台也能访问它。
若日志里已有通知请求,排查范围就转到程序内部:接口接收的请求方式、字段解析和签名规则是否与文档一致。签名失败时不要为了让订单变状态而临时跳过验证。应保留原始请求记录,在不暴露密钥的前提下,对照文档检查参与签名的字段及其处理方式。有些差错来自字段排序或空值处理;具体怎么计算,仍以所接平台的规则为准。
这条处理线可能停在平台通知未送达的阶段。开发者已确认服务器的通知地址可访问,还需向服务商提供商户订单号,请其核对实际投递地址和通知结果。测试期间,网站继续把该笔订单保留为待核实状态,不通过手工改库伪造一次“回调成功”。
回调收到后,订单怎样更新
程序收到通知,不代表可以立即交付。服务端应按接口文档验证签名,再将通知中的商户订单号、支付金额和交易状态与本地订单核对;金额不一致或订单不存在,就记录异常,暂不发货。回调里携带的交易号可以随订单保存,便于以后与平台记录对照。
支付平台可能因未收到商户的确认响应而再次发送通知。因此,订单更新要能处理重复请求:同一笔已支付订单再次收到有效通知时,直接按文档返回确认结果,不重复发放权益。订单状态更新和发货动作若分开执行,还要记录发货结果,避免出现“订单已支付、商品未交付”却无从补处理的情况。
上线前,用一笔测试订单走完下单、付款和异步通知,核对本地订单号与平台交易记录,再检查重复通知到来时的处理结果。若仍有订单停在待支付状态,从该订单的通知记录和服务器日志继续定位,不凭用户返回页面的显示文字改动订单。

