使用 Go SDK 快速开始

更新时间：2024.12.25

在本教程中，你将简要了解微信支付的 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 并学习了一些基础知识。接下来，你可以阅读具体的产品文档，学习如何接入微信支付。

文档是否有帮助

更多支持

开发者社区微信开放平台微信公众平台腾讯客服

使用 Go SDK 快速开始

# 环境要求

# 安装

# 必需的证书和密钥

# 发起请求

# 联系 SDK 团队获取帮助

# 接下来阅读

关于我们

服务支持

友情链接

客服帮助