个人支付收款实战：用Go版PayJS SDK从零接入微信支付宝

个人支付收款实战用Go版PayJS SDK从零接入微信支付宝【免费下载链接】payjs个人支付收款解决方案PayJS的Golang版本SDK项目地址: https://gitcode.com/gh_mirrors/pa/payjs凌晨两点我盯着自己做了两个月的个人工具站什么都完成了——除了收款。个人开发者接入微信、支付宝支付意味着营业执照、接口文档、签名算法、异步通知每一项都像一堵墙。那晚我翻到了PayJS 的 Golang 版本 SDKGitHub 加速计划 / pa / payjs一个把个人支付收款封装成一行的 Go 库。这篇文章就记录我如何用它在第二天早上把第一笔打赏收进了自己的账户。一、引子那台差一公里的支付车我的处境很典型个人开发者没有公司没有企业资质但有一个真实想收费的小工具。传统路径是申请企业微信支付——需要营业执照、对公账户、审核动辄两周。而我想要的是今天上线明天有人扫码付款钱直接进我自己的钱包。PayJS 解决的就是个人收款这最后一公里。它是支付宝与微信支付的个人接口解决方案而Go 版 PayJS SDK把这套接口的签名、请求、通知解析全部封装好了。我不需要理解 MD5 签名的拼接规则不需要手写 HTTP 调用甚至不需要知道异步通知的数据结构长什么样。对个人开发者来说支付不是技术问题是资质时间问题。SDK 把后者解决剩下的才轮到代码。二、初见从看不懂文档到收到1块钱说实话第一次go get之后我有点怀疑——整个 SDK 的核心入口文件payjs.go只有 100 行。打开一看结构清晰得像一张地图GetNative()扫码、GetCashier()收银台、GetJs()JSAPI、GetMiniApp()小程序、GetOrder()订单管理……一个支付网关该有的能力几乎全都在。对比一下同一件事的两种画面环节自己对接微信支付用 Go 版 PayJS SDK资质营业执照审核个人身份注册即可签名手写排序拼接MD5底层自动完成下单拼XML/JSON证书一行Create()通知手动解析验签回调函数直接收消息第一次成功运行时的体感就像拧开一个以为要开锁的瓶子结果它是旋盖的。配置文件只需要三个字段Key、MchID、NotifyUrl。当我看到终端里打出第一个二维码链接、用手机扫完收到支付成功四个字时我知道这一晚值了。三、实战从零搭一个打赏咖啡小站下面我们完整走一遍。主线项目叫打赏一杯咖啡一个首页生成二维码一个/notify接收支付结果。第一步准备环境# 拉取 SDK 源码 git clone https://gitcode.com/gh_mirrors/pa/payjs payjs-sdk # 新建你的业务项目 mkdir my-pay cd my-pay go mod init my-pay # 让项目引用本地 SDK go mod edit -replace payjs../payjs-sdk跑完后你会得到一个独立的 Go 项目payjs可以直接 import不依赖任何网络。第二步配置初始化config : payjs.Config{ Key: 你的通信密钥, // PayJS 控制台获取 MchID: 你的商户号, // 注册后分配 NotifyUrl: https://你的域名/notify, // 支付结果通知地址 } pay : payjs.New(config)这段代码做了所有初始化商户号、密钥、通知地址被打包进一个全局上下文后面所有支付方式都从它派生。运行后没有任何输出但它已经待命了。第三步核心操作——下单 收通知// 首页生成支付二维码 http.HandleFunc(/, func(w http.ResponseWriter, r *http.Request) { native : pay.GetNative() // 参数金额(分)、标题、订单号、附加数据、支付类型(留空微信) resp, err : native.Create(100, 打赏一杯咖啡, T001, from_blog, ) if err ! nil { fmt.Fprintf(w, 下单失败%v, err) return } fmt.Fprintf(w, img src%s /, resp.Qrcode) // resp.Qrcode 就是二维码图片地址 }) // 通知PayJS 推送支付结果 http.HandleFunc(/notify, func(w http.ResponseWriter, r *http.Request) { notify : pay.GetNotify(r, w) notify.SetMessageHandler(func(msg notify.Message) { // 这里处理支付成功更新数据库订单状态 fmt.Printf(订单 %s 支付成功金额 %d 分\n, msg.OutTradeNo, msg.TotalFee) }) notify.Serve() notify.SendResponseMsg() // 回复 success防止重复推送 }) http.ListenAndServe(:8080, nil)运行后打开http://localhost:8080会看到二维码手机扫码支付完成终端会打印一行订单 xxx 支付成功金额 100 分。整个过程从下单到通知回执我们没有手写一行签名逻辑。配图建议本地跑通后截一张终端输出支付成功的图替换为PayJS扫码支付运行效果。第四步收尾——订单对账支付成功 ≠ 万事大吉还要有兜底。用pay.GetOrder()主动查询orderAPI : pay.GetOrder() resp, err : orderAPI.Check(payjs订单号) // payjs_order_id if err nil resp.Status 1 { fmt.Println(该订单确实已支付金额, resp.TotalFee) }这一步用于异步通知丢失时的补偿查询是生产环境必备的第二只眼睛。四、进阶我踩过的坑和让 SDK 更好用的玩法坑一金额单位是分不是元。我第一次测试传了100以为是 1 元结果那是 100 元。PayJS 全系列接口金额单位都是分100 1 元先在心里换算好再下单。坑二签名验证不是万能的。SDK 内部对扫码支付、订单查询做了严格验签但 README 明确标注JSAPI 支付、用户资料、异步通知 IP 列表三个接口存在多维结构签名验证 BUG作者暂时注释了验签。用这三个接口时要自己在业务侧做金额和订单号核对别把安全完全交给它。坑三通知会重复推送必须幂等。支付平台的通知机制是不确认成功就重发。处理函数里先查订单状态已处理就直接返回success否则用订单号加锁再更新。坑四收银台的auto/hide参数是假 bool。官方文档写的是布尔值但源码注释里写得很清楚传true没用必须传1。SDK 作者特意把参数类型改成了int就是为了堵住这个坑。调用GetCashier().GetRequestUrl(...)时记得传1。进阶玩法定时对账起一个 goroutine每 5 分钟扫一遍本地待支付订单用Check主动确认状态弥补通知延迟。连接复用SDK 内部PostJSON每次新建 HTTP 连接高并发时换成带连接池的http.Client性能立刻上一个台阶。场景组合PC 端用GetNative()扫码、微信内用GetCashier()收银台、需要获取用户 openid 时用GetUser()一套 Config 全搞定。五、收尾把话说透回头看支付接入从来不是技术深水区而是资质门槛 信息差。Go 版 PayJS SDK 做的就是把这层门槛削平三个配置字段、一个New()、几个GetXXX()个人开发者也能在 30 分钟内拥有一套完整的收款链路。它不完美——三个接口的验签 BUG 还在 TODO 里躺着但这份诚实反而让用的人心里有底。下一步很具体把上面的代码复制到你自己的项目里先跑通扫码支付再补上通知幂等和订单对账。等第一笔真实的钱到账你会想起这句话——最好的支付接入是让你忘记自己在接支付。【免费下载链接】payjs个人支付收款解决方案PayJS的Golang版本SDK项目地址: https://gitcode.com/gh_mirrors/pa/payjs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考