gopay

README

GoPay

微信、支付宝、抖音、QQ、通联支付、拉卡拉、PayPal、扫呗、Apple支付的 Golang 版本SDK

---

一、安装

go get github.com/go-pay/gopay

查看 GoPay 版本

版本更新记录

import (
    "github.com/go-pay/gopay"
    "github.com/go-pay/xlog"
)

func main() {
    xlog.Info("GoPay Version: ", gopay.Version)
}

---

二、文档目录

点击查看不同支付方式的使用文档。方便的话，请留下您认可的小星星，十分感谢！

• 支付宝支付（V3版）

• 支付宝支付

• 微信支付（V3版）

  • 微信商家转账产品升级，目前已支持新版商家转账接口

• 微信支付（V2版，不推荐）

• 抖音支付

• 招商银行聚合支付

• QQ支付

• 通联支付

• 拉卡拉支付

• Paypal支付

• Apple支付校验

• 扫呗支付

---

三、其他说明

• 【v1.5.119 起 TLS 证书校验默认开启】 此前 pkg/xhttp.NewClient() 默认 tls.Config{InsecureSkipVerify: true}，存在中间人攻击风险（CWE-295），自 v1.5.119 起改为使用 Go 标准库默认安全配置。

  • 不影响生产环境：所有支付平台官方域名证书均受信任。
  • 沙箱 / 自签证书场景需手动恢复：New Client 后调用 SetHttpClient 注入跳过校验的 xhttp.Client：

    import (
        "crypto/tls"
        "github.com/go-pay/gopay/pkg/xhttp"
    )
    
    hc := xhttp.NewClient().SetHttpTLSConfig(&tls.Config{InsecureSkipVerify: true})
    client.SetHttpClient(hc) // wechat / alipay / douyin / paypal / qq / allinpay / lakala / saobei 均支持
    

• 如需自定义Log输出，New Client 后，调用 client.SetLogger() 方法设置自定义Logger，自定义Logger实现 xlog.XLogger interface即可。

• 各支付方式接入，请仔细查看 xxx_test.go 使用方式

  • gopay/wechat/v3/client_test.go
  • gopay/alipay/v3/client_test.go
  • gopay/alipay/client_test.go
  • gopay/examples/douyin/douyin.go（示例代码）
  • gopay/qq/client_test.go
  • gopay/allinpay/client_test.go
  • gopay/lakala/client_test.go
  • gopay/paypal/client_test.go
  • gopay/apple/verify_test.go
  • 或 examples

• 接入gopay示例项目(可参考接入使用方式)：gopay-platform

• 有问题请加微信群 或 关注抖音账号，加入首页粉丝群拉微信群。在此，非常感谢提出宝贵意见和反馈问题的同志们！

• 开发过程中，请尽量使用正式环境，1分钱测试法！

• 有偿承接技术咨询、开发，如需要加微信联系。

---

赞赏多少是您的心意，感谢支持！

微信赞赏码：      支付宝赞助码：

---

问题沟通（非必要不用加微信）

微信: 85411418（加个人微信备注清楚来意，谢谢）。

---

鸣谢

GoLand A Go IDE with extended support for JavaScript, TypeScript, and Databases。

特别感谢 JetBrains 为开源项目提供免费的 GoLand 等 IDE 的授权

Copyright © 2025 JetBrains s.r.o. JetBrains and the JetBrains logo are trademarks of JetBrains s.r.o.

Documentation

Index

• Constants
• Variables
• type BodyMap
  • func (bm BodyMap) CheckEmptyError(keys ...string) error
  • func (bm BodyMap) CheckNotAllEmptyError(keys ...string) error
  • func (bm BodyMap) EncodeAliPaySignParams() string
  • func (bm BodyMap) EncodeURLParams() string
  • func (bm BodyMap) EncodeWeChatSignParams(apiKey string) string
  • func (bm BodyMap) Get(key string) string
  • func (bm BodyMap) GetAny(key string) any
  • func (bm BodyMap) GetString(key string) string
  • func (bm BodyMap) JsonBody() (jb string)
  • func (bm BodyMap) MarshalXML(e *xml.Encoder, start xml.StartElement) (err error)
  • func (bm BodyMap) Range(f func(k string, v any) bool)
  • func (bm BodyMap) Remove(key string)
  • func (bm BodyMap) Reset()
  • func (bm BodyMap) Set(key string, value any) BodyMap
  • func (bm BodyMap) SetBodyMap(key string, value func(b BodyMap)) BodyMap
  • func (bm BodyMap) SetFormFile(key string, file *File) BodyMap
  • func (bm BodyMap) Unmarshal(ptr any) (err error)
  • func (bm *BodyMap) UnmarshalXML(d *xml.Decoder, start xml.StartElement) (err error)
• type DebugSwitch
• type File

Constants

const (
	NULL     = ""
	SUCCESS  = "SUCCESS"
	FAIL     = "FAIL"
	OK       = "OK"
	DebugOff = 0
	DebugOn  = 1
	Version  = "v1.5.123"
)

Variables

var (
	MissWechatInitParamErr = errors.New("missing wechat init parameter")
	MissAlipayInitParamErr = errors.New("missing alipay init parameter")
	MissPayPalInitParamErr = errors.New("missing paypal init parameter")
	MissAppleInitParamErr  = errors.New("missing apple init parameter")
	MissLakalaInitParamErr = errors.New("missing lakala init parameter")
	MissDouyinInitParamErr = errors.New("missing douyin init parameter")
	MissParamErr           = errors.New("missing required parameter")
	MarshalErr             = errors.New("marshal error")
	UnmarshalErr           = errors.New("unmarshal error")
	SignatureErr           = errors.New("signature error")
	VerifySignatureErr     = errors.New("verify signature error")
	CertNotMatchErr        = errors.New("cert not match error")
	GetSignDataErr         = errors.New("get signature data error")
	BodyMapNilErr          = errors.New("body map is nil")
)

Types

type BodyMap

type BodyMap map[string]any

func (BodyMap) CheckEmptyError

func (bm BodyMap) CheckEmptyError(keys ...string) error

func (BodyMap) CheckNotAllEmptyError

func (bm BodyMap) CheckNotAllEmptyError(keys ...string) error

func (BodyMap) EncodeAliPaySignParams

func (bm BodyMap) EncodeAliPaySignParams() string

("bar=baz&foo=quux") sorted by key.

func (BodyMap) EncodeURLParams

func (bm BodyMap) EncodeURLParams() string

("bar=baz&foo=quux") sorted by key.

func (BodyMap) EncodeWeChatSignParams

func (bm BodyMap) EncodeWeChatSignParams(apiKey string) string

("bar=baz&foo=quux") sorted by key.

func (BodyMap) Get

func (bm BodyMap) Get(key string) string

获取参数，同 GetString()

func (BodyMap) GetAny

func (bm BodyMap) GetAny(key string) any

获取原始参数

func (BodyMap) GetString

func (bm BodyMap) GetString(key string) string

获取参数转换string

func (BodyMap) JsonBody

func (bm BodyMap) JsonBody() (jb string)

func (BodyMap) MarshalXML

func (bm BodyMap) MarshalXML(e *xml.Encoder, start xml.StartElement) (err error)

func (BodyMap) Range

func (bm BodyMap) Range(f func(k string, v any) bool)

func (BodyMap) Remove

func (bm BodyMap) Remove(key string)

删除参数

func (BodyMap) Reset

func (bm BodyMap) Reset()

置空BodyMap

func (BodyMap) Set

func (bm BodyMap) Set(key string, value any) BodyMap

设置参数

func (BodyMap) SetBodyMap

func (bm BodyMap) SetBodyMap(key string, value func(b BodyMap)) BodyMap

func (BodyMap) SetFormFile

func (bm BodyMap) SetFormFile(key string, file *File) BodyMap

设置 FormFile

func (BodyMap) Unmarshal

func (bm BodyMap) Unmarshal(ptr any) (err error)

Unmarshal to struct or slice point

func (*BodyMap) UnmarshalXML

func (bm *BodyMap) UnmarshalXML(d *xml.Decoder, start xml.StartElement) (err error)

type DebugSwitch

type DebugSwitch int8

type File

type File struct {
	Name    string `json:"name"`
	Content []byte `json:"content"`
}