z35资讯网 ~ 极客资讯终端 v1.0 首页 专栏 订阅

收付款新手入门:第一次对接支付通道我踩过的坑

date // channel // 热点 id //

去年帮朋友的小程序接支付,我以为照着文档抄两行代码就完事了。结果从申请商户号到第一笔钱真正到账,折腾了整整11天。中间被驳回两次、对账对不上一次、还差点因为回调地址写错丢了一笔订单。这篇就把我踩过的坑和后来总结出来的流程讲清楚,给刚接触收付款的人省点时间。

先说个很多人一开始就搞错的事:收款和付款是两码事。收款是别人把钱给你,你关心的是能不能收进来、多久到账、手续费多少;付款是你把钱打给别人,比如给供应商结款、给用户退款,这时候关心的是限额、审核、到账速度。新手最容易混着看,结果签合同的时候才发现付款额度只有5万一天,根本不够用。

收付款新手入门:第一次对接支付通道我踩过的坑

搞清楚你要的是哪种通道

市面上常见的收付款方式大概这么几类,我按使用场景排一下:

收付款新手入门:第一次对接支付通道我踩过的坑

  • 微信支付 / 支付宝:适合C端小额,费率一般0.6%左右,个人和企业都能申请,到账T+1
  • 银行对公账户转账:大额、B端合作用得多,没手续费但慢,跨行可能当天不到
  • 第三方聚合支付:一个接口对接多个渠道,费率高一点点(0.38%~0.7%),省事
  • 企业网银批量代付:发工资、批量退款用,需要单独开通权限,通常有U盾或证书

收付款新手入门:第一次对接支付通道我踩过的坑

我当时选的是微信支付直连,因为用户都在微信里。如果你用户来源杂,抖音、H5、App都有,那聚合支付更省心,不然每个渠道都要单独申请一遍,光资料就能填吐。

申请到上线,卡点基本都在这几步

第一步是资质。个体户要营业执照,企业要营业执照加对公账户,个人想接微信支付基本走不通(除非用第三方的小微商户通道)。我朋友那个是公司主体,营业执照、法人身份证、对公账户信息、门店照片,一样都不能少。门店照片这块很多人翻车,要求是能看清招牌和经营场景,随手拍一张模糊的会被打回。

第二步是签协议和配置。商户号下来之后,要去商户平台下载API证书、设置APIv3密钥、配置回调域名。回调地址必须是https,而且不能带参数,我第一次写成了带query的地址,支付成功但订单状态一直没更新,查了两小时日志才发现。这个细节文档里写了,但字很小,容易略过。

第三步是测试。正式上线前一定要用沙箱或者1分钱的真实订单跑一遍完整流程:下单、支付、回调、退款。退款尤其要测,因为退款的回调逻辑和支付不一样,很多人只测了支付就上线,结果用户要退款的时候发现接口调不通。

第四步是对账。这是最容易被新手忽略的环节。平台每天会生成对账单文件,你得下载下来跟自己数据库的订单逐笔核对。我第一个月没做对账,月底发现有一笔订单支付成功了但系统里显示未支付,用户已经拿到货了。后来养成习惯,每天早上花十分钟跑一遍对账脚本,问题基本当天就能发现。

说实话,收付款这块技术难度不高,难的是细节和流程。我见过太多团队代码写得没问题,但卡在资质审核、回调配置、对账这些"非技术"环节上。给新手几个实在的建议:

  • 申请资料提前准备好扫描件,别等到提交时现拍现传
  • 回调接口一定要做幂等,同一个通知可能重复推送好几次
  • 金额字段统一用"分"为单位存整数,别用浮点数,不然迟早出精度问题
  • 上线前把退款、关闭订单、查询订单这几个接口都测一遍,别只测支付
  • 对账脚本早点写,哪怕先用Excel手动对,也比完全不对强

回到我朋友那个项目,最后跑通的时候是第11天,其中资质审核占了4天,剩下7天全耗在配置和调试上。现在再让我做一遍,估计3天能搞定,因为坑都踩过了。新手不用怕,收付款这东西就是一层窗户纸,把流程走通一次,后面接第二个渠道会快得多。

tags //
top