微信支付入门

在使用之前，请先阅读官方文档API V3 了解微信支付的大致工作流程。

微信支付是独立的一个服务，能够支持公众号、小程序、JSSDK、企业微信支付等平台，所以我们这边Payment拆分成了一个单独的实例。

Payment实例初始化

  2. PaymentService, err := payment.NewPayment(&payment.UserConfig{
  3.   AppID:       "[app_id]",         // 小程序、公众号或者企业微信的appid
  4.   MchID:       "[mch_id]",         // 商户号 appID
  5.   MchApiV3Key: "[mch_api_v3_key]", // 微信V3接口调用必填
  6.   Key:         "[key]",            // 微信V2接口调用必填
  7.   CertPath:    "[wx_cert_path]",   // 商户后台支付的Cert证书路径
  8.   KeyPath:     "[wx_key_path]",    // 商户后台支付的Key证书路径
  9.   SerialNo:    "[serial_no]",      // 商户支付证书序列号
  10.   NotifyURL:   "[notify_url]",
  11.   HttpDebug:   true,
  12.   Log: payment.Log{
  13.     Level: "debug",
  14.     File:  "./wechat.log",
  15.   },
  16.   Http: payment.Http{
  17.     Timeout: 30.0,
  18.     BaseURI: "https://api.mch.weixin.qq.com",
  19.   },
  20.   // 可选，不传默认走程序内存
  21.   Cache: kernel.NewRedisClient(&kernel.RedisOptions{
  22.     Addr:     "127.0.0.1:6379",
  23.     Password: "",
  24.     DB:       0,
  25.   }),
  26. })

UserConfig参数说明：

AppID

  • 类型: string
  • 必传: 是
  • 示例: ww16143ea0101327cc

小程序、公众号或者企业微信的appId。

MchID

  • 类型: string
  • 必传: 是
  • 示例: 1611854986

微信支付商户号ID

MchApiV3Key

  • 类型: string
  • 必传: 是
  • 示例: 1611854986

微信商户里面设置的API V3密钥。参考官方文档: API v3密钥

Key

  • 类型: string
  • 必传: 是
  • 示例: 管理员设置的随机数

微信商户里面设置的API V2密钥。参考官方文档: 配置API key

CertPath

  • 类型: string
  • 必传: 是
  • 示例: /.../apiclient_cert.pem

微信商户里面设置的API V3证书。参考官方文档: 私钥和证书

KeyPath

  • 类型: string
  • 必传: 是
  • 示例: /.../apiclient_key.pem

API V3私钥。

SerialNo

  • 类型: string
  • 必传: 是
  • 示例: 2655A2CD634B06C2A86B28780228A997D047B01A

微信支付V3证书的序列号。 获取证书调用方法：

  1. openssl x509 -noout -serial -in /.../apiclient_cert.pem

正常的情况下会输出：

  1. > serial=2655A2CD634B06C2A86B28780228A997D047B01A

NotifyURL

  • 类型: string
  • 必传: 是
  • 示例: https://pay.artisan-cloud.cn/wx/notify

微信支付完成后的通知回调地址。参考官方文档: 支付通知API

Log

  • 类型: payment.Log
  • 必传: 否
  • 示例:
  1. payment.Log{
  2.   Level: "debug",  // 输出日志等级
  3.   File:  "./wechat.log", //  输出日志文件
  4. }

输出日志到指定文件。

Http

  • 类型: payment.Http
  • 必传: 否
  • 示例:
  1. payment.Http{
  2.   Timeout: 30.0,
  3.   BaseURI: "https://api.mch.weixin.qq.com",
  4. }

设置微信支付地址，比如想要设置成沙盒地址，把里面的值改成https://api.mch.weixin.qq.com/sandboxnew就可以啦。

HttpDebug

  • 类型: bool
  • 必传: 否
  • 默认值：false

是否开启打印SDK调用微信API接口时候的日志，开启之后会显示出提交的参数和微信详情的数据，对于排查问题时候非常有帮助。

Cache

  • 类型: CacheInterface
  • 必传: 否
  • 默认值：nil

如果需要实现Token中控，例如多个应用实例共享或者和其他应用共享Token。

更多详细内容请参考： Cache配置