充值接入

支付宝入金接入流程:网站APP充值、支付回调与余额记账

支付宝入金,是用户通过支付宝向你的网站或APP付款充值。稳付pay确认支付结果后,把订单通知发送到你的服务器;你的系统完成验签和订单核对,再增加对应用户的站内余额。接入重点是让付款、通知和记账彼此可追溯,并确保同一笔付款不会被重复充值。

文章目录

一、区分用户充值、支付收款和账户记账

用户充值的是商户系统中的余额,并非给支付宝钱包本身充值。稳付pay负责已开通的支付宝原生代收通道、支付结果确认及通知;商户负责用户账户、余额流水、消费记录和售后规则。

充值页面应说明余额用途、有效期、赠送额度及退款条件。实付金额与赠送部分分别记录,不用最终增加的余额反推支付金额。消费、退款和人工调整各留独立流水,不能删除原充值记录来改账。本文所述服务不代表已开放支付宝出金或USDT兑换,独立代付接口暂未开放。

二、一笔支付宝充值怎样完成

  1. 用户提交充值后端绑定用户、确定金额,保存唯一充值订单。
  2. 创建支付宝支付调用已开通通道,展示真实返回的支付信息。
  3. 平台确认收款结果稳付pay关联原订单并确认支付成功。
  4. 发送服务端通知向商户配置的notifyUrl发送标准回调。
  5. 商户验签与核对检查签名、商户、订单、金额、币种和成功状态。
  6. 余额原子入账同一事务保存支付、唯一充值流水及余额更新。
付款成功与站内余额入账是相邻但独立的事实,商户必须可靠完成记账。

三、固定充值用户、金额和通道配置

下单前保存用户ID、商户订单号、金额、币种及充值规则快照。这些是商户自己的业务记录,不是接口新增参数。应付金额从后端可信数据计算,不能直接接受浏览器改价,也不能在回调到达后临时更换充值用户。

按代收下单与查询文档填写mchId、wayCode、outTradeNo、amount、notifyUrl、reqTime和sign等参数。amount单位为分,例如1000表示10.00元;reqTime使用当前毫秒时间戳。支付宝聚合编码为80001,仅在商户有授权且通道实际启用时可用。

“支付宝原生”是本站现有通道的业务名称。具体支付页面、设备要求和接入交互,由技术团队按配置联调,不承诺任意通道都支持所有APP、H5或扫码场景。只展示实际返回且有效的支付入口,不自行拼接收银台地址。

用户进入实际支付宝付款页后,应核对显示的收款方和应付金额。与当前充值订单不符时先暂停付款并联系商户核实,不自行改额后再要求后台认领。商户支付说明也应写清订单关联和查询入口,方便用户付款后回查。

四、用稳付pay协议核验回调

按签名规则与回调文档处理Body中的sign。回调优先使用CALLBACK_SECRET,未单独配置时使用MD5_SECRET;按实际非空字段排序拼接后计算小写MD5。保留00、10.00等原始字符串,不先转换成0、10再验签,密钥只保存于服务端。

验签后核对商户归属、业务类型、原订单、平台订单、分金额及币种,确认成功状态。未知订单或金额不符不能自动加余额,需保留异常并联系技术核查。前端跳转成功或用户点击“已付款”,只能触发向自己后端查询进度。

本站聚合接口与支付宝官方直连协议不同。支付宝官方SDK的RSA2签名实现不能替代这里的MD5规则;也不能把别处的success应答示例当作本文的处理流程。稳付pay标准回调建议在可靠保存后返回HTTP 200、纯文本OK。

五、以唯一流水保护账户余额

为充值流水建立数据库唯一约束,例如“商户+充值订单”。订单、支付记录、充值流水与余额变化应在同一事务内提交,不能先把余额加上,再单独写“已处理”。只在页面禁用按钮,或先查是否存在再写入,都挡不住并发通知。

验证通知并核对已保存的充值订单
开启数据库事务
  锁定订单与相关账户
  若已有该订单的成功充值流水:不再增加余额
  否则:保存唯一流水、增加对应用户余额、更新订单
提交事务
返回 HTTP 200,纯文本 OK

这是商户记账伪代码,不是新增接口。失败时回滚,不提前确认成功;已可靠处理的重复通知核实后可返回OK。查单确认成功也调用同一个记账函数,让回调、重试和人工补偿共享同一条防重复边界。

六、超时与重复通知先查原订单

情况处理方式
下单请求超时保留原订单号查单,不直接换号重复充值。
已付款但余额未变核对支付、通知处理和充值流水,不凭截图直接加款。
重复通知或查询并发进入同一个受唯一约束保护的记账事务。
过期订单出现有效付款保存支付事实,按约定补记或退款,不直接忽略。

用户支付宝账单里的交易记录、稳付pay返回的platformOrderNo、商户自己生成的outTradeNo,属于不同系统的标识,不应假定三者相同。后台应保存关联,客服用原商户订单定位后再核对支付证据,不能只按账单尾号、昵称或同金额匹配就加款。

稳付pay通知最多共3次,包含首次;前两次失败后约60秒、300秒重试,因此还需主动查单补偿。查询响应amount的单位在开通时确认后再转换比较,不直接当作下单分金额。支付宝官方SDK也提供交易查询请求,这里仅参考主动核实的概念,实际调用仍使用稳付pay代收查询接口。

七、用户充值和商户USDT结算分别对账

用户余额增加,说明商户账户系统完成记账;商户USDT结算完成,说明相应款项按约定结付到收款地址。这两层记录不能共用一个“完成”状态。

支付宝通道代收后可按双方约定进行T0实时USDT结算,网络、地址、换算和费用另行确认。结算待确认不能把用户已支付改成失败;用户已加余额,也不表示商户钱包已经收到USDT。详见商户结算完整流程,逐笔关联用户订单、支付记录、结算单和链上记录。

八、常见问题与上线前验收

付款后关掉页面,还能充值成功吗?

后端可以按有效通知或查单继续处理,不依赖用户返回页面,商户需实现可靠记账和补偿。

已有微信充值,可以共用账户余额吗?

可在商户系统共用余额账本,但订单保留支付方式与原通道,同一付款只产生一条有效充值流水。

现成支付宝插件改个网址就能接入吗?

先核对字段、签名、回调和查询是否匹配。官方直连插件不能仅替换网关就当作聚合适配完成,请技术团队协助联调。

上线前测试正常充值、错误签名、金额不符、重复通知、通知与查单并发、数据库回滚和晚到付款。每次核对订单、唯一流水和最终余额,确认金额正确且只加一次。微信接入可参看微信充值与余额入账。

参考资料

官方资料用于核对支付通知与扫码术语;稳付pay的接口字段、签名和通知应答以本站开发文档及开通配置为准。

按你的业务场景确认接入

说明商品、订单量、支付方式与结算需求,逐项确认接口、资金路径和异常处理。

联系稳付pay ↗