使用 Go SDK 快速开始

更新时间:2023.08.17

在本教程中,你将简要了解微信支付的 Go SDK。在学习过程中,你将

  • 掌握如何安装 Go SDK
  • 了解请求微信支付需要哪些密钥和证书
  • 了解如何使用 Go SDK 请求微信支付

# 环境要求

  • Go 1.16+

# 安装

使用 Go Modules (opens new window) 安装最新版本 SDK:

1go get github.com/wechatpay-apiv3/wechatpay-go

你可以在 GitHub 找到 Go SDK (opens new window) 的源代码、使用说明和最新版本信息。

# 必需的证书和密钥

运行 SDK 必需以下的证书和密钥:

# 发起请求

以 Native 支付为例,向微信支付发起你的第一个请求。

1package main
2
3import (
4 "context"
5 "log"
6
7 "github.com/wechatpay-apiv3/wechatpay-go/core"
8 "github.com/wechatpay-apiv3/wechatpay-go/core/option"
9 "github.com/wechatpay-apiv3/wechatpay-go/services/payments/native"
10 "github.com/wechatpay-apiv3/wechatpay-go/utils"
11)
12
13func main() {
14 var (
15 mchID string = "190000****" // 商户号
16 mchCertificateSerialNumber string = "3775B6A45ACD588826D15E583A95F5DD********" // 商户证书序列号
17 mchAPIv3Key string = "2ab9****************************" // 商户APIv3密钥
18 )
19
20 // 使用 utils 提供的函数从本地文件中加载商户私钥,商户私钥会用来生成请求的签名
21 mchPrivateKey, err: = utils.LoadPrivateKeyWithPath("/path/to/merchant/apiclient_key.pem")
22 if err != nil {
23 log.Fatal("load merchant private key error")
24 }
25
26 ctx: = context.Background()
27 // 使用商户私钥等初始化 client,并使它具有自动定时获取微信支付平台证书的能力
28 opts: = [] core.ClientOption {
29 option.WithWechatPayAutoAuthCipher(mchID, mchCertificateSerialNumber, mchPrivateKey, mchAPIv3Key),
30 }
31 client, err: = core.NewClient(ctx, opts...)
32 if err != nil {
33 log.Fatalf("new wechat pay client err:%s", err)
34 }
35
36 // 以 Native 支付为例
37 svc := native.NativeApiService{Client: client}
38 // 发送请求
39 resp, result, err: = svc.Prepay(ctx,
40 native.PrepayRequest {
41 Appid: core.String("wxd678efh567hg6787"),
42 Mchid: core.String("1900009191"),
43 Description: core.String("Image形象店-深圳腾大-QQ公仔"),
44 OutTradeNo: core.String("1217752501201407033233368018"),
45 Attach: core.String("自定义数据说明"),
46 NotifyUrl: core.String("https://www.weixin.qq.com/wxpay/pay.php"),
47 Amount: & native.Amount {
48 Total: core.Int64(100),
49 },
50 },
51 )
52 // 使用微信扫描 resp.code_url 对应的二维码,即可体验Native支付
53 log.Printf("status=%d resp=%s", result.Response.StatusCode, resp)
54}

# 联系 SDK 团队获取帮助

# 接下来阅读

通过这个快速介绍,你已经安装了 Go SDK 并学习了一些基础知识。接下来,你可以阅读具体的产品文档,学习如何接入微信支付。