README
¶
GoPay
微信、QQ、支付宝的Golang版本SDK
一、安装
- v1.5.42 开始，仓库从
github.com/iGoogle-ink/gopay迁移到github.com/go-pay/gopay
go get github.com/go-pay/gopay
-
查看 GoPay 版本
import (
"github.com/go-pay/gopay"
"github.com/go-pay/gopay/pkg/xlog"
)
func main() {
xlog.Debug("GoPay Version: ", gopay.Version)
}
微信支付V3 API
推荐使用V3接口，官方在V3接口实现未覆盖或gopay未开发的接口，还继续用V2接口，欢迎参与完善V3接口。
- 基础支付（商户平台）
- APP下单：
client.V3TransactionApp() - JSAPI/小程序下单：
client.V3TransactionJsapi() - Native下单：
client.V3TransactionNative() - H5下单：
client.V3TransactionH5() - 查询订单：
client.V3TransactionQueryOrder() - 关闭订单：
client.V3TransactionCloseOrder()
- APP下单：
- 基础支付（服务商平台）
- APP下单：
client.V3PartnerTransactionApp() - JSAPI/小程序下单：
client.V3PartnerTransactionJsapi() - Native下单：
client.V3PartnerTransactionNative() - H5下单：
client.V3PartnerTransactionH5() - 查询订单：
client.V3PartnerQueryOrder() - 关闭订单：
client.V3PartnerCloseOrder()
- APP下单：
- 合单支付
- 合单APP下单：
client.V3CombineTransactionApp() - 合单JSAPI/小程序下单：
client.V3CombineTransactionJsapi() - 合单Native下单：
client.V3CombineTransactionNative() - 合单H5下单：
client.V3CombineTransactionH5() - 合单查询订单：
client.V3CombineQueryOrder() - 合单关闭订单：
client.V3CombineCloseOrder()
- 合单APP下单：
- 退款
- 申请退款：
client.V3Refund() - 查询单笔退款：
client.V3RefundQuery()
- 申请退款：
- 账单
- 申请交易账单：
client.V3BillTradeBill() - 申请资金账单：
client.V3BillFundFlowBill() - 申请二级商户资金账单：
client.V3BillLevel2FundFlowBill() - 下载账单：
client.V3BillDownLoadBill()
- 申请交易账单：
- 微信支付分（公共API）
- 创建支付分订单：
client.V3ScoreOrderCreate() - 查询支付分订单：
client.V3ScoreOrderQuery() - 取消支付分订单：
client.V3ScoreOrderCancel() - 修改订单金额：
client.V3ScoreOrderModify() - 完结支付分订单：
client.V3ScoreOrderComplete() - 商户发起催收扣款：
client.V3ScoreOrderPay() - 同步服务订单信息：
client.V3ScoreOrderSync()
- 创建支付分订单：
- 微信支付分（免确认模式）
- 创单结单合并：
client.V3ScoreDirectComplete()
- 创单结单合并：
- 微信支付分（免确认预授权模式）
- 商户预授权：
client.V3ScorePermission() - 查询用户授权记录（授权协议号）：
client.V3ScorePermissionQuery() - 解除用户授权关系（授权协议号）：
client.V3ScorePermissionTerminate() - 查询用户授权记录（openid）：
client.V3ScorePermissionOpenidQuery() - 解除用户授权关系（openid）：
client.V3ScorePermissionOpenidTerminate()
- 商户预授权：
- 微信先享卡
- 预受理领卡请求：
client.V3DiscountCardApply() - 增加用户记录：
client.V3DiscountCardAddUser() - 查询先享卡订单：
client.V3DiscountCardQuery()
- 预受理领卡请求：
- 支付即服务
- 服务人员注册：
client.V3SmartGuideReg() - 服务人员分配：
client.V3SmartGuideAssign() - 服务人员查询：
client.V3SmartGuideQuery() - 服务人员信息更新：
client.V3SmartGuideUpdate()
- 服务人员注册：
- 智慧商圈
- 商圈积分同步：
client.V3BusinessPointsSync() - 商圈积分授权查询：
client.V3BusinessAuthPointsQuery()
- 商圈积分同步：
- 代金券
- 待实现
- 商家券
- 待实现
- 委托营销
- 待实现
- 消费卡
- 待实现
- 支付有礼
- 待实现
- 分账
- 请求分账：
client.V3ProfitShareOrder() - 查询分账结果：
client.V3ProfitShareOrderQuery() - 请求分账回退：
client.V3ProfitShareReturn() - 查询分账回退结果：
client.V3ProfitShareReturnResult() - 解冻剩余资金：
client.V3ProfitShareOrderUnfreeze() - 查询剩余待分金额：
client.V3ProfitShareUnsplitAmount() - 添加分账接收方：
client.V3ProfitShareAddReceiver() - 删除分账接收方：
client.V3ProfitShareDeleteReceiver()
- 请求分账：
- 消费者投诉2.0
- 查询投诉单列表：
client.V3ComplaintList() - 查询投诉单详情：
client.V3ComplaintDetail() - 查询投诉协商历史：
client.V3ComplaintNegotiationHistory() - 创建投诉通知回调地址：
client.V3ComplaintNotifyUrlCreate() - 查询投诉通知回调地址：
client.V3ComplaintNotifyUrlQuery() - 更新投诉通知回调地址：
client.V3ComplaintNotifyUrlUpdate() - 删除投诉通知回调地址：
client.V3ComplaintNotifyUrlDelete() - 提交回复：
client.V3ComplaintResponse() - 反馈处理完成：
client.V3ComplaintComplete() - 商户上传反馈图片：
client.V3ComplaintUploadImage()
- 查询投诉单列表：
- 其他能力
- 图片上传：
client.V3MediaUploadImage() - 视频上传：
client.V3MediaUploadVideo()
- 图片上传：
- 公共API
- 发起批量转账：
client.V3Transfer() - 微信批次单号查询批次单：
client.V3TransferQuery() - 微信明细单号查询明细单：
client.V3TransferDetailQuery() - 商家批次单号查询批次单：
client.V3TransferMerchantQuery() - 商家明细单号查询明细单：
client.V3TransferMerchantDetailQuery() - 转账电子回单申请受理：
client.V3TransferReceipt() - 查询转账电子回单：
client.V3TransferReceiptQuery() - 转账明细电子回单受理：
client.V3TransferDetailReceipt() - 查询转账明细电子回单受理结果：
client.V3TransferDetailReceiptQuery() - 查询账户实时余额：
client.V3MerchantBalance() - 查询账户日终余额：
client.V3MerchantDayBalance()
- 发起批量转账：
- 来账识别API
- 商户银行来账查询：
client.V3MerchantIncomeRecord()
- 商户银行来账查询：
- 特约商户进件（服务商平台）
- 提交申请单：
client.V3Apply4SubSubmit() - 查询申请单状态（BusinessCode）：
client.V3Apply4SubQueryByBusinessCode() - 查询申请单状态（ApplyId）：
client.V3Apply4SubQueryByApplyId() - 修改结算账号：
client.V3Apply4SubModifySettlement() - 查询结算账户：
client.V3Apply4SubQuerySettlement()
- 提交申请单：
QQ支付API
- 提交付款码支付：
client.MicroPay() - 撤销订单：
client.Reverse() - 统一下单：
client.UnifiedOrder() - 订单查询：
client.OrderQuery() - 关闭订单：
client.CloseOrder() - 申请退款：
client.Refund() - 退款查询：
client.RefundQuery() - 交易账单：
client.StatementDown() - 资金账单：
client.AccRoll() - 创建现金红包（未测试可用性）：
client.SendCashRed() - 对账单下载（未测试可用性）：
client.DownloadRedListFile() - 查询红包详情（未测试可用性）：
client.QueryRedInfo() - 自定义方法请求微信API接口：
client.PostQQAPISelf()
QQ公共API
qq.ParseNotifyToBodyMap()=> 解析QQ支付异步通知的结果到BodyMapqq.ParseNotify()=> 解析QQ支付异步通知的参数qq.VerifySign()=> QQ同步返回参数验签或异步通知参数验签
支付宝支付API
因支付宝接口太多，如没实现的接口，还请开发者自行调用
client.PostAliPayAPISelfV2()方法实现！请参考client_test.go内的TestClient_PostAliPayAPISelfV2()方法
希望有时间的伙伴儿Fork完后，积极提Pull Request，一起完善支付宝各个类别下的接口到相应的go文件中
- 支付宝接口自行实现方法：
client.PostAliPayAPISelfV2() - 网页&移动应用 - 支付API
- 统一收单交易支付接口（商家扫用户付款码）：
client.TradePay() - 统一收单线下交易预创建（用户扫商品收款码）：
client.TradePrecreate() - APP支付接口2.0（APP支付）：
client.TradeAppPay() - 手机网站支付接口2.0（手机网站支付）：
client.TradeWapPay() - 统一收单下单并支付页面接口（电脑网站支付）：
client.TradePagePay() - 统一收单交易创建接口（小程序支付）：
client.TradeCreate() - 统一收单线下交易查询:
client.TradeQuery() - 统一收单交易撤销接口:
client.TradeCancel() - 统一收单交易关闭接口:
client.TradeClose() - 统一收单交易退款接口:
client.TradeRefund() - 统一收单退款页面接口:
client.TradePageRefund() - 统一收单交易退款查询:
client.TradeFastPayRefundQuery() - 统一收单交易结算接口:
client.TradeOrderSettle() - 支付宝订单信息同步接口:
client.TradeOrderInfoSync() - 花芝轻会员结算申请:
client.PcreditHuabeiAuthSettleApply() - NFC用户卡信息同步:
client.CommerceTransportNfccardSend() - 广告投放数据查询:
client.DataDataserviceAdDataQuery() - 航司电话订票待申请接口:
client.CommerceAirCallcenterTradeApply() - 网商银行全渠道收单业务订单创建:
client.PaymentTradeOrderCreate() - 聚合支付订单咨询服务:
client.KoubeiTradeOrderAggregateConsult() - 口碑订单预下单:
client.KoubeiTradeOrderPrecreate() - 口碑商品交易购买接口:
client.KoubeiTradeItemorderBuy() - 口碑订单预咨询:
client.KoubeiTradeOrderConsult() - 口碑商品交易退货接口:
client.KoubeiTradeItemorderRefund() - 口碑商品交易查询接口:
client.KoubeiTradeItemorderQuery()
- 统一收单交易支付接口（商家扫用户付款码）：
- 网页&移动应用 - 资金API
- 单笔转账接口：
client.FundTransUniTransfer() - 查询转账订单接口:
client.FundTransOrderQuery() - 支付宝资金账户资产查询接口：
client.FundAccountQuery() - 转账业务单据查询接口：
client.FundTransCommonQuery() - 资金退回接口:
client.FundTransRefund() - 资金授权冻结接口:
client.FundAuthOrderFreeze() - 资金授权发码接口:
client.FundAuthOrderVoucherCreate() - 线上资金授权冻结接口: client:FundAuthOrderAppFreeze()`
- 资金授权解冻接口:
client.FundAuthOrderUnfreeze() - 资金授权操作查询接口:
client.FundAuthOperationDetailQuery() - 资金授权撤销接口:
client.FundAuthOperationCancel() - 批次下单接口:
client.FundBatchCreate() - 批量转账关单接口:
client.FundBatchClose() - 批量转账明细查询接口:
client.FundBatchDetailQuery() - 现金红包无线支付接口:
client.FundTransAppPay() - 资金收款账号绑定关系查询:
client.FundTransPayeeBindQuery()
- 单笔转账接口：
- 网页&移动应用 - 会员API
- 支付宝会员授权信息查询接口（App支付宝登录）：
client.UserInfoShare() - 身份认证初始化服务:
client.UserCertifyOpenInit() - 身份认证开始认证（获取认证链接）:
client.UserCertifyOpenCertify() - 身份认证记录查询:
client.UserCertifyOpenQuery() - 支付宝个人协议页面签约接口:
client.UserAgreementPageSign() - 支付宝个人代扣协议解约接口:
client.UserAgreementPageUnSign() - 支付宝个人代扣协议查询接口:
client.UserAgreementQuery() - 周期性扣款协议执行计划修改接口:
client.UserAgreementExecutionplanModify() - 协议由普通通用代扣协议产品转移到周期扣协议产品:
client.UserAgreementTransfer() - 通用当面付二阶段接口:
client.UserTwostageCommonUse() - 芝麻企业征信基于身份的协议授权:
client.UserAuthZhimaorgIdentityApply() - 查询是否在支付宝公益捐赠的接口:
client.UserCharityRecordexistQuery() - 集分宝发放接口:
client.UserAlipaypointSend() - isv 会员CRM数据回流:
client.MemberDataIsvCreate() - 询家人信息档案(选人授权)组件已选的家人档案信息:
client.UserFamilyArchiveQuery() - 初始化家人信息档案(选人授权)组件:
client.UserFamilyArchiveInitialize() - 实名证件信息比对验证预咨询:
client.UserCertdocCertverifyPreconsult() - 实名证件信息比对验证咨询:
client.UserCertdocCertverifyConsult() - 初始化家庭芝麻GO共享组件:
client.UserFamilyShareZmgoInitialize() - 数字分行银行码明细数据查询:
client.UserDtbankQrcodedataQuery() - 查询集分宝预算库详情:
client.UserAlipaypointBudgetlibQuery()
- 支付宝会员授权信息查询接口（App支付宝登录）：
- 网页&移动应用 - 营销API
- 小程序生成推广二维码接口：
client.OpenAppQrcodeCreate()
- 小程序生成推广二维码接口：
- 网页&移动应用 - 工具类API
- 用户登陆授权：
client.UserInfoAuth() - 换取授权访问令牌：
client.SystemOauthToken() - 换取应用授权令牌：
client.OpenAuthTokenApp() - 应用支付宝公钥证书下载：
client.PublicCertDownload()
- 用户登陆授权：
- 网页&移动应用 - 芝麻信用API
- 芝麻企业信用信用评估初始化:
client.ZhimaCreditEpSceneRatingInitialize() - 信用服务履约同步:
client.ZhimaCreditEpSceneFulfillmentSync() - 加入信用服务:
clinet.ZhimaCreditEpSceneAgreementUse() - 取消信用服务:
client.ZhimaCreditEpSceneAgreementCancel() - 信用服务履约同步(批量):
client.ZhimaCreditEpSceneFulfillmentlistSync() - 芝麻go用户数据回传:
client.ZhimaCreditPeZmgoCumulationSync() - 商家芝麻GO累计数据回传接口:
client.ZhimaMerchantZmgoCumulateSync() - 商家芝麻GO累计数据查询接口:
client.ZhimaMerchantZmgoCumulateQuery() - 芝麻GO签约关单:
client.ZhimaCreditPeZmgoBizoptClose() - 芝麻GO结算退款接口:
client.ZhimaCreditPeZmgoSettleRefund() - 芝麻GO签约预创单:
client.ZhimaCreditPeZmgoPreorderCreate() - 芝麻GO协议解约:
client.ZhimaCreditPeZmgoAgreementUnsign() - 芝麻Go协议查询接口:
client.ZhimaCreditPeZmgoAgreementQuery() - 芝麻Go解冻接口:
client.ZhimaCreditPeZmgoSettleUnfreeze() - 芝麻GO支付下单链路签约申请:
client.ZhimaCreditPeZmgoPaysignApply() - 芝麻GO支付下单链路签约确认:
client.ZhimaCreditPeZmgoPaysignConfirm() - 职得工作证信息匹配度查询:
client.ZhimaCustomerJobworthAdapterQuery() - 职得工作证外部渠道应用数据回流:
client.ZhimaCustomerJobworthSceneUse()
- 芝麻企业信用信用评估初始化:
- 网页&移动应用 - 财务API
支付宝商家账户当前余额查询：client.DataBillBalanceQuery()（失效）- 查询对账单下载地址：
client.DataBillDownloadUrlQuery()
- 网页&移动应用 - 海关相关API
- 统一收单报关接口：
client.TradeCustomsDeclare() - 报关接口：
client.AcquireCustoms() - 报关查询接口：
client.AcquireCustomsQuery()
- 统一收单报关接口：
支付宝公共API
alipay.GetCertSN()=> 获取证书SN号（app_cert_sn、alipay_cert_sn）alipay.GetRootCertSN()=> 获取证书SN号（alipay_root_cert_sn）alipay.GetRsaSign()=> 获取支付宝参数签名（参数sign值）alipay.SystemOauthToken()=> 换取授权访问令牌（得到access_token，user_id等信息）alipay.FormatPrivateKey()=> 格式化应用私钥alipay.FormatPublicKey()=> 格式化支付宝公钥alipay.FormatURLParam()=> 格式化支付宝请求URL参数alipay.ParseNotifyToBodyMap()=> 解析支付宝支付异步通知的参数到BodyMapalipay.ParseNotifyByURLValues()=> 通过 url.Values 解析支付宝支付异步通知的参数到BodyMapalipay.VerifySign()=> 支付宝异步通知参数验签alipay.VerifySignWithCert()=> 支付宝异步通知参数验签（证书方式）alipay.VerifySyncSign()=> 支付宝同步返回参数验签alipay.DecryptOpenDataToStruct()=> 解密支付宝开放数据到 结构体alipay.DecryptOpenDataToBodyMap()=> 解密支付宝开放数据到 BodyMapalipay.MonitorHeartbeatSyn()=> 验签接口
二、文档说明
- GoPay 文档地址
- 微信支付V2文档
- QQ支付 使用方法请参考微信支付V2的文档
- 所有方法，如有问题，请仔细查看
wechat/client_test.go、alipay/client_test.go或 examples - 有问题请加QQ群（加群验证答案：gopay），微信加好友拉群（微信群有两个，一个活跃群，聊的内容比较杂，一个只聊技术群，平时很少说话，加好友后说明加哪个群，默认全邀请）。在此，非常感谢那些加群后，提出意见和反馈问题的同志们！
QQ群：
加微信拉群：
1、初始化GoPay客户端并做配置（HTTP请求均默认设置tls.Config{InsecureSkipVerify: true}）
-
微信V3
注意：V3 版本接口持续增加中，不支持沙箱支付，测试请用1分钱测试法
注意：
微信平台证书和微信平台证书序列号，请自行通过wechat.GetPlatformCerts()方法维护
具体使用介绍，请参考
gopay/wechat/v3/client_test.go
import (
"github.com/go-pay/gopay/wechat/v3"
)
// NewClientV3 初始化微信客户端 V3
// appid：appid 或者服务商模式的 sp_appid
// mchid：商户ID 或者服务商模式的 sp_mchid
// serialNo：商户证书的证书序列号
// apiV3Key：apiV3Key，商户平台获取
// pkContent：私钥 apiclient_key.pem 读取后的内容
client, err = wechat.NewClientV3(Appid, MchId, SerialNo, APIv3Key, PKContent)
if err != nil {
xlog.Error(err)
return
}
// 设置微信平台证书和序列号，并启用自动同步返回验签
// 注意：请预先通过 wechat.GetPlatformCerts() 获取并维护微信平台证书和证书序列号
client.SetPlatformCert([]byte(WxPkContent), WxPkSerialNo).AutoVerifySign()
// 打开Debug开关，输出日志，默认是关闭的
client.DebugSwitch = gopay.DebugOn
-
支付宝
支付宝官方文档：官方文档
支付宝RSA秘钥生成文档：生成RSA密钥 （推荐使用 RSA2）
技术支持 & 案例 FAQ：秘钥问题
沙箱环境使用说明：文档地址
import (
"github.com/go-pay/gopay/alipay"
)
// 初始化支付宝客户端
// appId：应用ID
// privateKey：应用私钥，支持PKCS1和PKCS8
// isProd：是否是正式环境
client := alipay.NewClient("2016091200494382", privateKey, false)
// 打开Debug开关，输出日志，默认关闭
client.DebugSwitch = gopay.DebugOn
// 设置支付宝请求 公共参数
// 注意：具体设置哪些参数，根据不同的方法而不同，此处列举出所有设置参数
client.SetLocation(). // 设置时区，不设置或出错均为默认服务器时间
SetPrivateKeyType(). // 设置 支付宝 私钥类型，alipay.PKCS1 或 alipay.PKCS8，默认 PKCS1
SetAliPayRootCertSN(). // 设置支付宝根证书SN，通过 alipay.GetRootCertSN() 获取
SetAppCertSN(). // 设置应用公钥证书SN，通过 alipay.GetCertSN() 获取
SetAliPayPublicCertSN(). // 设置支付宝公钥证书SN，通过 alipay.GetCertSN() 获取
SetCharset("utf-8"). // 设置字符编码，不设置默认 utf-8
SetSignType(alipay.RSA2). // 设置签名类型，不设置默认 RSA2
SetReturnUrl("https://www.fmm.ink"). // 设置返回URL
SetNotifyUrl("https://www.fmm.ink"). // 设置异步通知URL
SetAppAuthToken() // 设置第三方应用授权
// 自动同步验签（只支持证书模式）
// 传入 alipayCertPublicKey_RSA2.crt 内容
client.AutoVerifySign("alipayCertPublicKey_RSA2 bytes")
// 公钥证书模式，需要传入证书，以下两种方式二选一
// 证书路径
err := client.SetCertSnByPath("appCertPublicKey.crt", "alipayRootCert.crt", "alipayCertPublicKey_RSA2.crt")
// 证书内容
err := client.SetCertSnByContent("appCertPublicKey bytes", "alipayRootCert bytes", "alipayCertPublicKey_RSA2 bytes")
2、初始化并赋值BodyMap（client的方法所需的入参）
-
微信请求参数
具体参数请根据不同接口查看：微信支付V3的API字典概览
import (
"github.com/go-pay/gopay"
)
// JSAPI下单 示例
expire := time.Now().Add(10 * time.Minute).Format(time.RFC3339)
// 初始化 BodyMap
bm := make(gopay.BodyMap)
bm.Set("description", "测试Jsapi支付商品").
Set("out_trade_no", tradeNo).
Set("time_expire", expire).
Set("notify_url", "https://www.fmm.ink").
SetBodyMap("amount", func(bm gopay.BodyMap) {
bm.Set("total", 1).
Set("currency", "CNY")
}).
SetBodyMap("payer", func(bm gopay.BodyMap) {
bm.Set("openid", "asdas")
})
-
支付宝请求参数
具体参数请根据不同接口查看：支付宝支付API接口文档
import (
"github.com/go-pay/gopay"
)
// 统一收单交易支付接口 示例
// 初始化 BodyMap
bm := make(gopay.BodyMap)
bm.Set("subject", "条码支付").
Set("scene", "bar_code").
Set("auth_code", "286248566432274952").
Set("out_trade_no", "GZ201909081743431443").
Set("total_amount", "0.01").
Set("timeout_express", "2m")
3、client 方法调用
-
微信V3
// 公共方法
client.SetPlatformCert()
client.AutoVerifySign()
client.V3EncryptText()
client.V3DecryptText()
// 直连商户
wxRsp, err := client.V3TransactionApp()
wxRsp, err := client.V3TransactionJsapi()
wxRsp, err := client.V3TransactionNative()
wxRsp, err := client.V3TransactionH5()
wxRsp, err := client.V3TransactionQueryOrder()
wxRsp, err := client.V3TransactionCloseOrder(bm)
// 服务商
wxRsp, err := client.V3PartnerTransactionApp()
wxRsp, err := client.V3PartnerTransactionJsapi()
wxRsp, err := client.V3PartnerTransactionNative()
wxRsp, err := client.V3PartnerTransactionH5()
wxRsp, err := client.V3PartnerQueryOrder()
wxRsp, err := client.V3PartnerCloseOrder()
// 合单
wxRsp, err := client.V3CombineTransactionApp()
wxRsp, err := client.V3CombineTransactionJsapi()
wxRsp, err := client.V3CombineTransactionNative()
wxRsp, err := client.V3CombineTransactionH5()
wxRsp, err := client.V3CombineQueryOrder()
wxRsp, err := client.V3CombineCloseOrder()
...
-
支付宝
// 手机网站支付是通过服务端获取支付URL后，然后返回给客户端，请求URL地址即可打开支付页面
payUrl, err := client.TradeWapPay()
// 电脑网站支付是通过服务端获取支付URL后，然后返回给客户端，请求URL地址即可打开支付页面
payUrl, err := client.TradePagePay()
// APP支付是通过服务端获取支付参数后，然后通过Android/iOS客户端的SDK调用支付功能
payParam, err := client.TradeAppPay()
// 商家使用扫码枪等条码识别设备扫描用户支付宝钱包上的条码/二维码，完成收款
aliRsp, err := client.TradePay()
// 支付宝小程序支付时 buyer_id 为必传参数，需要提前获取，获取方法如下两种
// 1、alipay.SystemOauthToken() 返回取值：aliRsp.SystemOauthTokenResponse.UserId
// 2、client.SystemOauthToken() 返回取值：aliRsp.SystemOauthTokenResponse.UserId
aliRsp, err := client.TradeCreate()
aliRsp, err := client.TradeQuery()
aliRsp, err := client.TradeClose()
aliRsp, err := client.TradeCancel()
aliRsp, err := client.TradeRefund()
aliRsp, err := client.TradePageRefund()
aliRsp, err := client.TradeFastPayRefundQuery()
aliRsp, err := client.TradeOrderSettle()
aliRsp, err := client.TradePrecreate()
...
4、微信下单后，获取微信小程序支付、APP支付、JSAPI支付所需要的 pay sign
-
微信V3
小程序调起支付API：小程序调起支付API
APP调起支付API：APP调起支付API
JSAPI调起支付API：JSAPI调起支付API
H5调起支付API：H5调起支付API
// jsapi
jsapi, err := client.PaySignOfJSAPI("prepayid")
// app
app, err := client.PaySignOfApp("prepayid")
// 小程序
applet, err := client.PaySignOfApplet("prepayid")
5、同步返回参数验签Sign、异步通知参数解析和验签Sign、异步通知返回
异步通知请求参数需要先解析，解析出来的结构体或BodyMap再验签（此处需要注意，
http.Request.Body只能解析一次，如果需要解析前调试，请处理好Body复用问题）
-
微信V3
import (
"github.com/go-pay/gopay/wechat/v3"
"github.com/go-pay/gopay/pkg/xlog"
)
// ========同步返回 手动验签（如已开启自动验签，则无需手动验签操作）========
wxRsp, err := client.V3TransactionJsapi(bm)
if err != nil {
xlog.Error(err)
return
}
err = wechat.V3VerifySign(wxRsp.SignInfo.HeaderTimestamp, wxRsp.SignInfo.HeaderNonce, wxRsp.SignInfo.SignBody, wxRsp.SignInfo.HeaderSignature, WxPkContent)
if err != nil {
xlog.Error(err)
return
}
// ========异步通知验签========
notifyReq, err := wechat.V3ParseNotify()
if err != nil {
xlog.Error(err)
return
}
// WxPkContent 是通过 wechat.GetPlatformCerts() 接口向微信获取的微信平台公钥证书内容
err = notifyReq.VerifySign(WxPkContent)
if err != nil {
xlog.Error(err)
return
}
// ========异步通知敏感信息解密========
// 普通支付通知解密
result, err := notifyReq.DecryptCipherText(apiV3Key)
// 合单支付通知解密
result, err := notifyReq.DecryptCombineCipherText(apiV3Key)
// 退款通知解密
result, err := notifyReq.DecryptRefundCipherText(apiV3Key)
// ========异步通知应答========
// 退款通知http应答码为200且返回状态码为SUCCESS才会当做商户接收成功，否则会重试。
// 注意：重试过多会导致微信支付端积压过多通知而堵塞，影响其他正常通知。
// 此写法是 gin 框架返回微信的写法
c.JSON(http.StatusOK, &wechat.V3NotifyRsp{Code: gopay.SUCCESS, Message: "成功"})
// 此写法是 echo 框架返回微信的写法
return c.JSON(http.StatusOK, &wechat.V3NotifyRsp{Code: gopay.SUCCESS, Message: "成功"})
-
支付宝
注意：APP支付、手机网站支付、电脑网站支付 不支持同步返回验签
支付宝支付后的同步/异步通知验签文档：支付结果通知
import (
"github.com/go-pay/gopay/alipay"
)
// ====同步返回参数 手动验签（如已开启自动验签，则无需手动验签操作）====
aliRsp, err := client.TradePay(bm)
// 公钥模式验签
// 注意：APP支付，手机网站支付，电脑网站支付 不支持同步返回验签
// aliPayPublicKey：支付宝平台获取的支付宝公钥
// signData：待验签参数，aliRsp.SignData
// sign：待验签sign，aliRsp.Sign
ok, err := alipay.VerifySyncSign(aliPayPublicKey, aliRsp.SignData, aliRsp.Sign)
// 公钥证书模式验签
// aliPayPublicKeyCert：支付宝公钥证书存放路径 alipayCertPublicKey_RSA2.crt 或文件内容[]byte
// signData：待验签参数，aliRsp.SignData
// sign：待验签sign，aliRsp.Sign
ok, err := alipay.VerifySyncSignWithCert(aliPayPublicKeyCert, aliRsp.SignData, aliRsp.Sign)
// ====异步通知参数解析和验签Sign====
// 解析异步通知的参数
// req：*http.Request
notifyReq, err = alipay.ParseNotifyToBodyMap(c.Request) // c.Request 是 gin 框架的写法
或
// value：url.Values
notifyReq, err = alipay.ParseNotifyByURLValues()
// 支付宝异步通知验签（公钥模式）
ok, err = alipay.VerifySign(aliPayPublicKey, notifyReq)
// 支付宝异步通知验签（公钥证书模式）
ok, err = alipay.VerifySignWithCert("alipayCertPublicKey_RSA2.crt content", notifyReq)
// ====异步通知，返回支付宝平台的信息====
// 文档：https://opendocs.alipay.com/open/203/105286
// 程序执行完后必须打印输出“success”（不包含引号）。如果商户反馈给支付宝的字符不是success这7个字符，支付宝服务器会不断重发通知，直到超过24小时22分钟。一般情况下，25小时以内完成8次通知（通知的间隔频率一般是：4m,10m,10m,1h,2h,6h,15h）
// 此写法是 gin 框架返回支付宝的写法
c.String(http.StatusOK, "%s", "success")
// 此写法是 echo 框架返回支付宝的写法
return c.String(http.StatusOK, "success")
6、微信、支付宝 公共API（仅部分说明）
-
微信V3 公共API
微信敏感信息加解密、回调接口敏感信息解密
import (
"github.com/go-pay/gopay/wechat/v3"
)
// 获取微信平台证书和序列号信息
wechat.GetPlatformCerts()
// 请求参数 敏感信息加密
wechat.V3EncryptText() 或 client.V3EncryptText()
// 返回参数 敏感信息解密
wechat.V3DecryptText() 或 client.V3DecryptText()
// 回调通知敏感信息解密
wechat.V3DecryptNotifyCipherText()
wechat.V3DecryptRefundNotifyCipherText()
wechat.V3DecryptCombineNotifyCipherText()
...
-
支付宝 公共API
支付宝换取授权访问令牌文档：换取授权访问令牌
小程序获取用户手机号文档：获取用户手机号
import (
"github.com/go-pay/gopay/alipay"
"github.com/go-pay/gopay/pkg/xlog"
)
// 换取授权访问令牌（默认使用utf-8，RSA2）
// appId：应用ID
// privateKey：应用私钥，支持PKCS1和PKCS8
// grantType：值为 authorization_code 时，代表用code换取；值为 refresh_token 时，代表用refresh_token换取，传空默认code换取
// codeOrToken：支付宝授权码或refresh_token
rsp, err := alipay.SystemOauthToken(appId, privateKey, grantType, codeOrToken)
// 解密支付宝开放数据带到指定结构体
// 以小程序获取手机号为例
phone := new(alipay.UserPhone)
// 解密支付宝开放数据
// encryptedData:包括敏感数据在内的完整用户信息的加密数据
// secretKey:AES密钥，支付宝管理平台配置
// beanPtr:需要解析到的结构体指针
err := alipay.DecryptOpenDataToStruct(encryptedData, secretKey, phone)
xlog.Debugf("%+v", phone)
赞赏多少是您的心意，感谢！
微信：
支付宝：
License
Copyright 2019 Jerry
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Documentation
¶
Index ¶
- Constants
- type BodyMap
- func (bm BodyMap) CheckEmptyError(keys ...string) error
- func (bm BodyMap) EncodeAliPaySignParams() string
- func (bm BodyMap) EncodeGetParams() string
- func (bm BodyMap) EncodeWeChatSignParams(apiKey string) string
- func (bm BodyMap) Get(key string) string
- func (bm BodyMap) GetInterface(key string) interface{}
- 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) Remove(key string)
- func (bm BodyMap) Reset()
- func (bm BodyMap) Set(key string, value interface{}) BodyMap
- func (bm BodyMap) SetBodyMap(key string, value func(bm BodyMap)) BodyMap
- func (bm BodyMap) SetFormFile(key string, file *util.File) BodyMap
- func (bm *BodyMap) UnmarshalXML(d *xml.Decoder, start xml.StartElement) (err error)
- type DebugSwitch
Constants ¶
View Source
const ( NULL = "" SUCCESS = "SUCCESS" FAIL = "FAIL" OK = "OK" DebugOff = 0 DebugOn = 1 Version = "1.5.53" )
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type BodyMap ¶
type BodyMap map[string]interface{}
func (BodyMap) CheckEmptyError ¶ added in v1.5.42
func (BodyMap) EncodeAliPaySignParams ¶ added in v1.5.42
("bar=baz&foo=quux") sorted by key.
func (BodyMap) EncodeGetParams ¶ added in v1.5.42
("bar=baz&foo=quux")
func (BodyMap) EncodeWeChatSignParams ¶ added in v1.5.42
("bar=baz&foo=quux") sorted by key.
func (BodyMap) GetInterface ¶ added in v1.5.42
获取原始参数
func (BodyMap) MarshalXML ¶ added in v1.5.42
func (BodyMap) SetBodyMap ¶ added in v1.5.42
func (BodyMap) SetFormFile ¶ added in v1.5.42
设置 FormFile
func (*BodyMap) UnmarshalXML ¶ added in v1.5.42
type DebugSwitch ¶ added in v1.5.42
type DebugSwitch int8
Source Files
Directories
Click to show internal directories.
Click to hide internal directories.