支付宝入金接入流程:网站APP充值、支付回调与余额记账
支付宝入金,是用户通过支付宝向你的网站或APP付款充值。稳付pay确认支付结果后,把订单通知发送到你的服务器;你的系统完成验签和订单核对,再增加对应用户的站内余额。接入重点是让付款、通知和记账彼此可追溯,并确保同一笔付款不会被重复充值。
文章目录
一、区分用户充值、支付收款和账户记账
用户充值的是商户系统中的余额,并非给支付宝钱包本身充值。稳付pay负责已开通的支付宝原生代收通道、支付结果确认及通知;商户负责用户账户、余额流水、消费记录和售后规则。
充值页面应说明余额用途、有效期、赠送额度及退款条件。实付金额与赠送部分分别记录,不用最终增加的余额反推支付金额。消费、退款和人工调整各留独立流水,不能删除原充值记录来改账。本文所述服务不代表已开放支付宝出金或USDT兑换,独立代付接口暂未开放。
二、一笔支付宝充值怎样完成
- 用户提交充值后端绑定用户、确定金额,保存唯一充值订单。
- 创建支付宝支付调用已开通通道,展示真实返回的支付信息。
- 平台确认收款结果稳付pay关联原订单并确认支付成功。
- 发送服务端通知向商户配置的notifyUrl发送标准回调。
- 商户验签与核对检查签名、商户、订单、金额、币种和成功状态。
- 余额原子入账同一事务保存支付、唯一充值流水及余额更新。
三、固定充值用户、金额和通道配置
下单前保存用户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。详见商户结算完整流程,逐笔关联用户订单、支付记录、结算单和链上记录。
八、常见问题与上线前验收
付款后关掉页面,还能充值成功吗?
后端可以按有效通知或查单继续处理,不依赖用户返回页面,商户需实现可靠记账和补偿。
已有微信充值,可以共用账户余额吗?
可在商户系统共用余额账本,但订单保留支付方式与原通道,同一付款只产生一条有效充值流水。
现成支付宝插件改个网址就能接入吗?
先核对字段、签名、回调和查询是否匹配。官方直连插件不能仅替换网关就当作聚合适配完成,请技术团队协助联调。
上线前测试正常充值、错误签名、金额不符、重复通知、通知与查单并发、数据库回滚和晚到付款。每次核对订单、唯一流水和最终余额,确认金额正确且只加一次。微信接入可参看微信充值与余额入账。