充值接入

微信入金接入流程:用户充值、支付确认与余额入账

这里的“微信入金”,是用户使用微信给你的网站或APP付款充值:稳付pay确认支付结果后通知你的服务器,你的系统核验通知,再给对应用户增加站内余额。付款确认与余额记账各有职责,接入时必须把它们串成可核对、可重试且不重复充值的完整流程。

文章目录

一、先明确入金到哪里、谁负责记账

用户购买的是你站点或应用里的充值金额,不是向微信钱包本身充值。稳付pay负责接入已开通的微信支付通道、确认付款结果并发送订单通知;商户负责维护用户账户、余额流水和后续消费规则。

充值页面应写清余额可消费的范围、有效期和售后规则。有赠送额度时,实付金额与赠送部分分别记录,不能用最终增加的余额反推支付金额。消费、退款或人工调整也应产生独立流水,保留原因与关联订单,不能删除原充值记录来改账。

一次充值应能从用户账户追溯到商户订单,再追溯到平台支付记录。不能只凭用户昵称、截图或同金额付款认领余额,也不要把“订单已创建”当成“充值已到账”。本文不表示已提供微信提现或USDT兑换功能,独立代付接口暂未开放。

二、一笔微信充值的六步流程

  1. 用户发起充值选择金额,商户后端绑定用户并生成唯一充值订单。
  2. 展示微信支付入口后端调用已开通通道,展示实际返回的支付信息。
  3. 稳付pay确认付款关联原订单并核实支付成功结果。
  4. 发送服务端回调向商户配置的通知地址发送标准支付通知。
  5. 商户验签核对验证签名、商户、订单、金额、币种及成功状态。
  6. 原子增加用户余额同一事务保存支付、唯一余额流水与余额更新,再确认通知。
用户看到付款页面,只是完成支付流程的一部分;余额入账以商户后端可靠记账为准。

三、下单前固定用户与应付金额

先保存本地充值订单,记录用户ID、商户订单号、应付金额、币种及充值规则快照。这些是商户自己的业务数据,不代表接口额外接受同名参数。金额由后端计算,不能让前端修改价格或通过回调重新指定充值用户。

按代收下单文档传入商户号、已开通的通道编码、订单号、金额、通知地址、当前毫秒时间戳和签名。下单金额单位为分,例如1000表示10.00元。微信聚合编码为90001,但是否可用以商户授权和实际配置为准。

微信个码与原生通道的展示方式、设备限制和操作步骤,由技术团队在接入时确认;不要自行拼造支付入口。微信官方Native产品说明可帮助理解扫码术语,但稳付pay的聚合MD5协议不能当作微信官方API使用。

四、收到回调后,先验证再准备入账

按标准回调文档验证Body中的sign:优先使用配置的CALLBACK_SECRET,未单独配置才使用MD5_SECRET。保留通知原值后验签,不提前把00变为0、把10.00变为10;密钥只放在服务端。

验签通过仍需核对商户号、业务类型、原订单号、平台订单号、金额及币种,确认成功状态。回调amount单位分,应与本地应付金额一致。用户应由已保存的原订单确定,不能由通知里的任意附加值替换。

未知订单、金额不符或状态冲突应记录异常并联系技术核实,不自动加余额。浏览器返回成功或用户点击“已付款”,只能让前端向自己的后端查询充值进度。

五、唯一流水和余额更新必须一起提交

为充值流水设置数据库唯一约束,例如以“商户+充值订单”作为业务唯一键;订单、流水与用户余额放在同一事务中更新。先查有没有再写入,无法挡住两个并发回调。

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

以上是商户记账伪代码,不是稳付pay新增接口。数据库出错则回滚,不先回复成功。已确认处理过的重复通知可返回OK;余额流水、支付记录和账户更新应始终一致。查单补偿也调用这一处理函数,不另写一条绕过幂等检查的加款路径。

六、超时、重复通知与晚到付款怎么处理

场景正确处理
创建请求超时用原订单号查单,不直接更换单号再充值。
付款后余额未增加核对支付、回调处理和本地流水,不能凭截图直接加款。
重复回调或查单并发统一进入唯一流水约束保护的记账事务。
订单过期后收到有效付款保存付款事实,按约定补入账或处理退款,不直接忽略。

稳付pay标准通知最多共3次,含首次,前两次失败后约60秒、300秒重试,因此还需主动查单补偿。查询响应金额单位在开通时确认后再换算比较。微信官方回调与查单指引也强调,通知可能延迟或遗漏,页面返回后仍需服务端核实;本文不照搬其API字段或应答规则。

七、用户余额与商户USDT结算分开核对

“用户充值成功”表示用户在商户系统中的余额已正确增加;“商户结算完成”表示相关款项按约定结付给商户。两者不是同一笔账户余额,也不是同一个状态。

渠道代收后可按双方约定进行T0实时USDT结算,网络、地址、换算与费用另行确认。结算仍在确认不能把用户已付款改成失败;用户已经加款,也不等于商户钱包已收到USDT。详见商户结算完整流程。

八、常见问题与上线验收

用户关闭页面后,还能充值到账吗?

可以按服务端结果继续处理,不依赖用户回到网页。商户需正确接收通知并执行查单补偿。

重复回调会把余额加两次吗?

正确实现唯一充值流水与原子事务后,同一付款只入账一次;只在页面上禁用按钮不能防止并发重复记账。

怎样开始接入稳付pay?

联系技术团队说明网站或APP、充值规则和支付需求,确认通道与商户配置,再按开发文档联调。

上线前至少验证正常充值、重复通知、通知与查单并发、数据库失败回滚、关闭页面和晚到付款。每个测试都要核对订单、支付记录、余额流水和最终余额,确认金额准确且只加一次。

参考资料

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

按你的业务场景确认接入

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

联系稳付pay ↗