wxpay

package module
v1.1.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 6, 2021 License: MIT Imports: 17 Imported by: 0

README

wxpay

Powered by zch Language License

wxpay 提供了以下的方法:

方法名 说明
MicroPay 刷卡支付
UnifiedOrder 统一下单
OrderQuery 查询订单
Reverse 撤销订单
CloseOrder 关闭订单
Refund 申请退款
RefundQuery 查询退款
DownloadBill 下载对账单
Report 交易保障
ShortUrl 转换短链接
AuthCodeToOpenid 授权码查询openid
  • 参数为Params类型,返回类型也是ParamsParams 是一个 map[string]string 类型。
  • 方法内部会将参数会转换成含有appidmch_idnonce_strsign_typesign的XML;
  • 默认使用MD5进行签名;
  • 通过HTTPS请求得到返回数据后会对其做必要的处理(例如验证签名,签名错误则抛出异常)。
  • 对于DownloadBill,无论是否成功都返回Map,且都含有return_codereturn_msg。若成功,其中return_codeSUCCESS,另外data对应对账单数据。

安装

$ go get github.com/objcoding/wxpay

go modules

// go.mod
require github.com/objcoding/wxpay v1.0.5

示例

// 创建支付账户
account1 := wxpay.NewAccount("appid", "mchid", "apiKey", false)
account2 := wxpay.NewAccount("appid", "mchid", "apiKey", false)

// 新建微信支付客户端
client := wxpay.NewClient(account1)

// 设置证书
account.SetCertData("证书地址")

// 设置支付账户
client.setAccount(account2)

// 设置http请求超时时间
client.SetHttpConnectTimeoutMs(2000)

// 设置http读取信息流超时时间
client.SetHttpReadTimeoutMs(1000)

// 更改签名类型
client.SetSignType(HMACSHA256)

// 统一下单
params := make(wxpay.Params)
params.SetString("body", "test").
		SetString("out_trade_no", "436577857").
		SetInt64("total_fee", 1).
		SetString("spbill_create_ip", "127.0.0.1").
		SetString("notify_url", "http://notify.objcoding.com/notify").
		SetString("trade_type", "APP")
p, _ := client.UnifiedOrder(params)

// 订单查询
params := make(wxpay.Params)
params.SetString("out_trade_no", "3568785")
p, _ := client.OrderQuery(params)

// 退款
params := make(wxpay.Params)
params.SetString("out_trade_no", "3568785").
		SetString("out_refund_no", "19374568").
		SetInt64("total_fee", 1).
		SetInt64("refund_fee", 1)
p, _ := client.Refund(params)

// 退款查询
params := make(wxpay.Params)
params.SetString("out_refund_no", "3568785")
p, _ := client.RefundQuery(params)

// 签名
signStr := client.Sign(params)

// 校验签名
b := client.ValidSign(params)

// xml解析
params := wxpay.XmlToMap(xmlStr)

// map封装xml请求参数
b := wxpay.MapToXml(params)

// 支付或退款返回成功信息
return wxpay.Notifies{}.OK()

// 支付或退款返回失败信息
return wxpay.Notifies{}.NotOK("支付失败或退款失败了")

objcoding

License

MIT license

Documentation

Index

Constants

View Source
const (
	Fail                       = "FAIL"
	Success                    = "SUCCESS"
	HMACSHA256                 = "HMAC-SHA256"
	MD5                        = "MD5"
	Sign                       = "sign"
	MicroPayUrl                = "https://api.mch.weixin.qq.com/pay/micropay"
	UnifiedOrderUrl            = "https://api.mch.weixin.qq.com/pay/unifiedorder"
	OrderQueryUrl              = "https://api.mch.weixin.qq.com/pay/orderquery"
	ReverseUrl                 = "https://api.mch.weixin.qq.com/secapi/pay/reverse"
	CloseOrderUrl              = "https://api.mch.weixin.qq.com/pay/closeorder"
	RefundUrl                  = "https://api.mch.weixin.qq.com/secapi/pay/refund"
	TransfersUrl               = "https://api.mch.weixin.qq.com/mmpaymkttransfers/promotion/transfers"
	RefundQueryUrl             = "https://api.mch.weixin.qq.com/pay/refundquery"
	DownloadBillUrl            = "https://api.mch.weixin.qq.com/pay/downloadbill"
	DownloadFundFlowUrl        = "https://api.mch.weixin.qq.com/pay/downloadfundflow"
	ReportUrl                  = "https://api.mch.weixin.qq.com/payitil/report"
	ShortUrl                   = "https://api.mch.weixin.qq.com/tools/shorturl"
	AuthCodeToOpenidUrl        = "https://api.mch.weixin.qq.com/tools/authcodetoopenid"
	SandboxMicroPayUrl         = "https://api.mch.weixin.qq.com/sandboxnew/pay/micropay"
	SandboxUnifiedOrderUrl     = "https://api.mch.weixin.qq.com/sandboxnew/pay/unifiedorder"
	SandboxOrderQueryUrl       = "https://api.mch.weixin.qq.com/sandboxnew/pay/orderquery"
	SandboxReverseUrl          = "https://api.mch.weixin.qq.com/sandboxnew/secapi/pay/reverse"
	SandboxCloseOrderUrl       = "https://api.mch.weixin.qq.com/sandboxnew/pay/closeorder"
	SandboxRefundUrl           = "https://api.mch.weixin.qq.com/sandboxnew/secapi/pay/refund"
	SandboxRefundQueryUrl      = "https://api.mch.weixin.qq.com/sandboxnew/pay/refundquery"
	SandboxDownloadBillUrl     = "https://api.mch.weixin.qq.com/sandboxnew/pay/downloadbill"
	SandboxDownloadFundFlowUrl = "https://api.mch.weixin.qq.com/sandboxnew/pay/downloadfundflow"
	SandboxReportUrl           = "https://api.mch.weixin.qq.com/sandboxnew/payitil/report"
	SandboxShortUrl            = "https://api.mch.weixin.qq.com/sandboxnew/tools/shorturl"
	SandboxAuthCodeToOpenidUrl = "https://api.mch.weixin.qq.com/sandboxnew/tools/authcodetoopenid"
)

Variables

This section is empty.

Functions

func MapToXml

func MapToXml(params Params) string

Types

type Account

type Account struct {
	// contains filtered or unexported fields
}

func NewAccount

func NewAccount(appID string, mchID string, apiKey string, isSanbox bool) *Account

创建微信支付账号

func (*Account) SetCertData

func (a *Account) SetCertData(certPath string)

设置证书

type Client

type Client struct {
	// contains filtered or unexported fields
}

func NewClient

func NewClient(account *Account) *Client

创建微信支付客户端

func (*Client) AuthCodeToOpenid

func (c *Client) AuthCodeToOpenid(params Params) (Params, error)

授权码查询OPENID接口

func (*Client) CloseOrder

func (c *Client) CloseOrder(params Params) (Params, error)

关闭订单

func (*Client) DownloadBill

func (c *Client) DownloadBill(params Params) (Params, error)

对账单下载

func (*Client) DownloadFundFlow

func (c *Client) DownloadFundFlow(params Params) (Params, error)

func (*Client) MicroPay

func (c *Client) MicroPay(params Params) (Params, error)

刷卡支付

func (*Client) OrderQuery

func (c *Client) OrderQuery(params Params) (Params, error)

订单查询

func (*Client) Refund

func (c *Client) Refund(params Params) (Params, error)

退款

func (*Client) RefundQuery

func (c *Client) RefundQuery(params Params) (Params, error)

退款查询

func (*Client) Report

func (c *Client) Report(params Params) (Params, error)

交易保障

func (*Client) Reverse

func (c *Client) Reverse(params Params) (Params, error)

撤销订单

func (*Client) SetAccount

func (c *Client) SetAccount(account *Account)

func (*Client) SetHttpConnectTimeoutMs

func (c *Client) SetHttpConnectTimeoutMs(ms int)

func (*Client) SetHttpReadTimeoutMs

func (c *Client) SetHttpReadTimeoutMs(ms int)

func (*Client) SetSignType

func (c *Client) SetSignType(signType string)

func (*Client) ShortUrl

func (c *Client) ShortUrl(params Params) (Params, error)

转换短链接

func (*Client) Sign

func (c *Client) Sign(params Params) string

签名

func (*Client) Transfers

func (c *Client) Transfers(params Params) (Params, error)

Transfers 企业付款到零钱

func (*Client) UnifiedOrder

func (c *Client) UnifiedOrder(params Params) (Params, error)

统一下单

func (*Client) ValidSign

func (c *Client) ValidSign(params Params) bool

验证签名

type Notifies

type Notifies struct{}

func (*Notifies) NotOK

func (n *Notifies) NotOK(errMsg string) string

通知不成功

func (*Notifies) OK

func (n *Notifies) OK() string

通知成功

type Params

type Params map[string]string

func XmlToMap

func XmlToMap(xmlStr string) Params

func (Params) ContainsKey

func (p Params) ContainsKey(key string) bool

判断key是否存在

func (Params) GetInt64

func (p Params) GetInt64(k string) int64

func (Params) GetString

func (p Params) GetString(k string) string

func (Params) SetInt64

func (p Params) SetInt64(k string, i int64) Params

func (Params) SetString

func (p Params) SetString(k, s string) Params

map本来已经是引用类型了,所以不需要 *Params

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL