码支付指南

mzf-guide
用户付款后返回网站,不代表业务订单已经确认。本文说明浏览器返回页、服务端通知和订单查询的分工,并给出处理中提示、权限校验与联调场景。
首页 > 码支付指南 > 正文内容

码支付同步返回与异步通知有什么区别?支付结果页设计指南

admin2个月前 (09-17)码支付指南128

用户扫码后回到网站,页面显示“支付成功”,但会员权限还未开通;也有用户付款后直接关闭页面,后台却已经收到通知。这两种现象说明,浏览器页面跳转与服务端订单确认并不是同一件事。把两者分开处理,能减少误判与重复付款。

一、返回页负责展示,服务端负责确认

同步返回通常由用户浏览器发起,目的是把用户带回商户网站。用户可能关闭页面、网络断开或手动刷新,因此不能把“访问到成功页”当成唯一的付款依据,也不能信任地址栏中未经服务端验证的成功参数。

异步通知通常由支付服务向商户服务端发送。商户应按所接平台文档验证通知,核对订单归属、金额与状态,再更新本地订单。通知可能延迟或重复,浏览器返回也可能先于通知到达。具体字段名、签名方法、成功应答格式与重试机制,以实际接入平台文档为准。

二、让支付结果页读取可信的订单状态

结果页拿到订单标识后,应请求商户自己的服务端查询订单。服务端先校验当前用户是否有权查看该订单,再返回必要的状态与展示信息。不能因为请求中带了一个真实订单号,就允许任意访客读取付款与商品信息。

页面可以区分“等待付款”“正在确认”“已确认付款”和“需要人工核对”等状态。其中“已确认付款”也不一定等于“商品已交付”,会员开通或数字内容发放应另外展示处理结果。

三、通知尚未到达时,避免催促重复付款

用户自述已付款、本地订单仍在等待确认时,可以显示“付款结果正在确认,请稍后刷新订单”,并保留订单查询入口。前端可以按有限频率查询本地状态,到达等待上限后停止自动刷新,转为提示稍后查看或联系客服。

不要把前端倒计时结束直接解释为付款失败,也不要在状态不明时自动创建一笔新支付订单。若实际平台支持服务端订单查询,可按其接口权限、频率限制与状态定义进行核验;未确认平台具备该能力前,不应自行拼接猜测的接口。

四、回调与查询必须汇入同一套处理规则

如果通知和主动查询先后确认同一笔付款,两条路径应调用相同的校验与订单更新逻辑。完成状态转换前再次检查当前记录,避免重复入账或重复开通权限。订单已确认后,浏览器反复刷新只能更新显示,不能再次执行发货。

遇到金额不符、订单不存在或记录相互矛盾时,应保留待核对状态和审计记录,不要为了让页面看起来成功而强制更改结果。

五、上线前至少测试六种情况

  1. 正常付款后返回网站,订单与交付状态准确展示。

  2. 付款后关闭浏览器,服务端仍能独立处理有效通知。

  3. 返回页先打开、通知稍后到达,页面能从确认中更新到正确状态。

  4. 通知重复到达或结果页多次刷新,没有重复交付。

  5. 修改地址栏参数或查询其他用户订单,不能伪造成功或读取他人信息。

  6. 通知暂时不可用时,页面有明确的查询与人工核对入口。

联调应使用平台提供的测试环境或明确批准的测试订单,不要通过伪造生产通知验证真实交付。相关基础流程可阅读码支付接入流程;接入参数请从码支付首页进入开发文档核对。

通用异步通知设计参考:Stripe 官方 Webhook 文档。该资料用于说明服务端通知的设计原则,不代表本站采用 Stripe 的接口、签名或应答规则。

扫描二维码推送至手机访问。

版权声明:本文由码支付发布,如需转载请注明出处。

转载请注明出处https://www.junzhifu.com/?id=15

分享给朋友:

相关文章

码支付通知地址收不到回调怎么办?HTTPS、白名单与日志排查

码支付接入后,常见故障之一是用户已经付款,但业务系统的订单仍停留在“待支付”。这通常不是单一环节造成的,而是支付监控、通知请求、服务器接收和业务更新之间某一步没有完成。排查时应保留订单号、通知时间和原...

码支付回调验签失败怎么排查?参数、签名与幂等处理指南

为什么支付成功却没有自动发货?码支付完成后,支付平台通常会向商户服务器发送异步通知。商户系统只有在验证签名、核对订单并正确返回响应后,才应把订单更新为已支付。用户已经付款但订单状态未变化,常见原因包括...

个人免签码支付是什么?收款原理、适用场景与接入注意事项

个人免签码支付是什么?很多个人开发者和小型网站在搭建付费功能时,会接触到“码支付”或“个人免签支付”。它通常利用已有的收款码、订单识别与异步通知,把付款结果同步给网站业务系统。理解它的边界和工作流程,...

个人网站收款系统上线前检查:安全、订单与异常处理清单

为什么上线前需要逐项检查?个人网站接入收款功能后,用户支付、订单状态、业务交付和资金记录会形成一条连续链路。任何一个环节配置不完整,都可能造成支付成功却未开通服务、重复交付、金额不一致或故障难以追踪。...

个人收款码怎样减少漏单?金额识别、到账监控与每日对账方法

为什么收到了钱,网站订单却没有完成个人网站使用收款码时,资金到账和业务订单更新是两套状态。用户付款成功后,监控端需要识别到账记录,支付服务需要匹配订单,最后商户回调接口还要完成验签和入账。任何一段中断...

码支付如何处理支付通知延迟?重试、幂等与人工补单方案

码支付系统收到付款结果后,通常会通过异步通知把订单状态推送给业务系统。网络抖动、服务器短暂不可用、队列拥堵或应用重启,都可能造成通知延迟。可靠的处理方式不是无限等待,也不是简单重复发货,而是建立“可重...

准备开始接入码支付?

进入运营站查看平台功能、商户后台与最新接入说明