- v1.5.42 开始，仓库从
github.com/iGoogle-ink/gopay迁移到github.com/go-pay/gopay
go get github.com/go-pay/gopayimport (
"github.com/go-pay/gopay"
"github.com/go-pay/gopay/pkg/xlog"
)
func main() {
xlog.Debug("GoPay Version: ", gopay.Version)
}- 基础支付（商户平台）
- 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.V3FavorBatchCreate() - 激活代金券批次：
client.V3FavorBatchStart() - 发放代金券批次：
client.V3FavorBatchGrant() - 暂停代金券批次：
client.V3FavorBatchPause() - 重启代金券批次：
client.V3FavorBatchRestart() - 条件查询批次列表：
client.V3FavorBatchList() - 查询批次详情：
client.V3FavorBatchDetail() - 查询代金券详情：
client.V3FavorDetail() - 查询代金券可用商户：
client.V3FavorMerchant() - 查询代金券可用单品：
client.V3FavorItems() - 根据商户号查用户的券：
client.V3FavorUserCoupons() - 下载批次核销明细：
client.V3FavorUseFlowDownload() - 下载批次退款明细：
client.V3FavorRefundFlowDownload() - 设置消息通知地址：
client.V3FavorCallbackUrlSet()
- 创建代金券批次：
- 商家券
- 创建商家券：
client.V3BusiFavorBatchCreate() - 查询商家券详情：
client.V3BusiFavorBatchDetail() - 核销用户券：
client.V3BusiFavorUse() - 根据过滤条件查询用户券：
client.V3BusiFavorUserCoupons() - 查询用户单张券详情：
client.V3BusiFavorUserCouponDetail() - 上传预存code：
client.V3BusiFavorCodeUpload() - 设置商家券事件通知地址：
client.V3BusiFavorCallbackUrlSet() - 查询商家券事件通知地址：
client.V3BusiFavorCallbackUrl() - 关联订单信息：
client.V3BusiFavorAssociate() - 取消关联订单信息：
client.V3BusiFavorDisassociate() - 修改批次预算：
client.V3BusiFavorBatchUpdate() - 修改商家券基本信息：
client.V3BusiFavorInfoUpdate() - 申请退券：
client.V3BusiFavorReturn() - 使券失效：
client.V3BusiFavorDeactivate() - 营销补差付款：
client.V3BusiFavorSubsidyPay() - 查询营销补差付款单详情：
client.V3BusiFavorSubsidyPayDetail()
- 创建商家券：
- 委托营销
- 待实现
- 消费卡
- 待实现
- 支付有礼
- 待实现
- 分账
- 请求分账：
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()
- 提交申请单：
wechat.GetPlatformCerts()=> 获取微信平台证书公钥wechat.V3VerifySign()=> 微信V3 版本验签（同步/异步）wechat.V3ParseNotify()=> 解析微信回调请求的参数到 V3NotifyReq 结构体wechat.V3EncryptText()=> 敏感参数信息加密wechat.V3DecryptText()=> 敏感参数信息解密wechat.V3DecryptNotifyCipherText()=> 解密 普通支付 回调中的加密信息wechat.V3DecryptRefundNotifyCipherText()=> 解密 普通退款 回调中的加密信息wechat.V3DecryptCombineNotifyCipherText()=> 解密 合单支付 回调中的加密信息wechat.V3DecryptScoreNotifyCipherText()=> 解密 支付分 回调中的加密信息client.PaySignOfJSAPI()=> 获取 JSAPI 支付 paySignclient.PaySignOfApp()=> 获取 APP 支付 paySignclient.PaySignOfApplet()=> 获取 小程序 支付 paySign
- 提交付款码支付：
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.ParseNotifyToBodyMap()=> 解析QQ支付异步通知的结果到BodyMapqq.ParseNotify()=> 解析QQ支付异步通知的参数qq.VerifySign()=> QQ同步返回参数验签或异步通知参数验签
- 支付宝接口自行实现方法：
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() - 码商发码成功回调接口:
client.KoubeiTradeTicketTicketcodeSend() - 口碑凭证延期接口:
client.KoubeiTradeTicketTicketcodeDelay() - 口碑凭证码查询:
client.KoubeiTradeTicketTicketcodeQuery() - 口碑凭证码撤销核销:
client.KoubeiTradeTicketTicketcodeCancel() - 修改蚂蚁店铺:
client.AntMerchantShopModify() - 蚂蚁店铺创建:
client.AntMerchantShopCreate() - 蚂蚁店铺创建咨询:
client.AntMerchantShopConsult() - 商户申请单查询:
client.AntMerchantOrderQuery() - 店铺查询接口:
client.AntMerchantShopQuery() - 蚂蚁店铺关闭:
client.AntMerchantShopClose()
- 统一收单交易支付接口（商家扫用户付款码）：
- 网页&移动应用 - 资金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()
- 统一收单报关接口：
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()=> 验签接口
url 请选择 apple.UrlSandbox 或 apple.UrlProd
apple.VerifyReceipt()=> 苹果支付校验收据API
- GoPay 文档地址
- 微信支付V2文档
- QQ支付 使用方法请参考微信支付V2的文档
- 所有方法，如有问题，请仔细查看
wechat/client_test.go、alipay/client_test.go或 examples - 有问题请加QQ群（加群验证答案：gopay），微信加好友拉群（微信群有两个，一个活跃群，聊的内容比较杂，一个只聊技术群，平时很少说话，加好友后说明加哪个群，默认全邀请）。在此，非常感谢那些加群后，提出意见和反馈问题的同志们！
QQ群：
加微信拉群：
注意：V3 版本接口持续增加中，不支持沙箱支付，测试请用1分钱测试法
注意：
微信平台证书和微信平台证书序列号，请自行通过wechat.GetPlatformCerts()方法维护
具体使用介绍，请参考
gopay/wechat/v3/client_test.go
import (
"github.com/go-pay/gopay/wechat/v3"
)
// NewClientV3 初始化微信客户端 V3
// mchid：商户ID 或者服务商模式的 sp_mchid
// serialNo：商户证书的证书序列号
// apiV3Key：apiV3Key，商户平台获取
// privateKey：私钥 apiclient_key.pem 读取后的内容
client, err = wechat.NewClientV3(MchId, SerialNo, APIv3Key, PrivateKey)
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(). // 设置时区，不设置或出错均为默认服务器时间
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")具体参数请根据不同接口查看：微信支付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")// 公共方法
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()
...小程序调起支付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")异步通知请求参数需要先解析，解析出来的结构体或BodyMap再验签（此处需要注意，
http.Request.Body只能解析一次，如果需要解析前调试，请处理好Body复用问题）
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")微信敏感信息加解密、回调接口敏感信息解密
import (
"github.com/go-pay/gopay/wechat/v3"
)
// 获取微信平台证书和序列号信息
wechat.GetPlatformCerts()
// 请求参数 敏感信息加密
wechat.V3EncryptText() 或 client.V3EncryptText()
// 返回参数 敏感信息解密
wechat.V3DecryptText() 或 client.V3DecryptText()
// 回调通知敏感信息解密
wechat.V3DecryptNotifyCipherText()
wechat.V3DecryptRefundNotifyCipherText()
wechat.V3DecryptCombineNotifyCipherText()
...支付宝换取授权访问令牌文档：换取授权访问令牌
小程序获取用户手机号文档：获取用户手机号
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)微信：
支付宝：
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.