---
url: "https://pay.weixin.qq.com/doc/v3/partner/4012083113.md"
title: "使用 Go SDK"
doc_id: 4012083113
---

>更新时间：2025.05.29

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

- 掌握如何安装 Go SDK

- 了解请求微信支付需要哪些密钥和证书

- 了解如何使用 Go SDK 请求微信支付




## 环境要求

- Go 1.16+


## 安装

使用 [Go Modules](https://github.com/golang/go/wiki/Modules) 安装最新版本 SDK：

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

你可以在 GitHub 找到 [Go SDK](https://github.com/wechatpay-apiv3/wechatpay-go) 的源代码、使用说明和最新版本信息。

## 必需的证书和密钥

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

- [商户 API 私钥](https://pay.weixin.qq.com/doc/v3/merchant/4013053053.md#%E5%A6%82%E4%BD%95%E8%8E%B7%E5%8F%96%E5%95%86%E6%88%B7API%E8%AF%81%E4%B9%A6%E7%A7%81%E9%92%A5%EF%BC%9F)

- [商户 API 证书](https://pay.weixin.qq.com/doc/v3/merchant/4013053053.md)的证书序列号

- [API v3密钥](https://pay.weixin.qq.com/doc/v3/merchant/4013053267.md)


## 发起请求

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

```
package main
import (
	"context"
	"log"
	"time"
	"github.com/wechatpay-apiv3/wechatpay-go/core"
	"github.com/wechatpay-apiv3/wechatpay-go/core/option"
	"github.com/wechatpay-apiv3/wechatpay-go/services/partnerpayments/native"
	"github.com/wechatpay-apiv3/wechatpay-go/utils"
)
func main() {
    var (
        mchID string = "190000****" // 商户号
        mchCertificateSerialNumber string = "3775B6A45ACD588826D15E583A95F5DD********" // 商户证书序列号
        mchAPIv3Key string = "2ab9****************************" // 商户APIv3密钥
    )
    // 使用 utils 提供的函数从本地文件中加载商户私钥，商户私钥会用来生成请求的签名
    mchPrivateKey, err: = utils.LoadPrivateKeyWithPath("/path/to/merchant/apiclient_key.pem")
    if err != nil {
        log.Fatal("load merchant private key error")
    }
    ctx: = context.Background()
    // 使用商户私钥等初始化 client，并使它具有自动定时获取微信支付平台证书的能力
    opts: = [] core.ClientOption {
        option.WithWechatPayAutoAuthCipher(mchID, mchCertificateSerialNumber, mchPrivateKey, mchAPIv3Key),
    }
    client, err: = core.NewClient(ctx, opts...)
    if err != nil {
        log.Fatalf("new wechat pay client err:%s", err)
    }
    // 以 Native 支付为例
    svc := native.NativeApiService{Client: client}
    // 发送请求
    resp, result, err: = svc.Prepay(ctx,
        native.PrepayRequest{
			SpAppid: core.String("wxd678efh567hg6787"),
			SpMchid: core.String("1230000109"),
			SubAppid: core.String("wxd678efh567hg6787"),
			SubMchid: core.String("1230000109"),
			Description: core.String("Image形象店-深圳腾大-QQ公仔"),
			OutTradeNo: core.String("1217752501201407033233368018"),
			NotifyUrl: core.String("https://www.weixin.qq.com/wxpay/pay.php"),
            Amount: & native.Amount {
                Total: core.Int64(100),
            },
        },
    )
    // 使用微信扫描 resp.code_url 对应的二维码，即可体验Native支付
    log.Printf("status=%d resp=%s", result.Response.StatusCode, resp)
}
```

## 联系 SDK 团队获取帮助

- 在[开发者社区](https://developers.weixin.qq.com/community/pay)提交问题

- 在 GitHub 上[提交 issue](https://github.com/wechatpay-apiv3/wechatpay-go/issues)

- 联系我们的[在线技术支持](https://support.pay.weixin.qq.com/aidevhelper)


## 接下来阅读

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