-
已实现API列表附录：API 列表附录
-
开发文档（V3版）：开发文档（V3版）
-
接口规则：接口规则
-
支付宝RSA秘钥生成文档：生成RSA密钥 （推荐使用 RSA2）
-
沙箱环境(新) 使用说明：新版沙箱文档
具体API使用介绍，请参考
gopay/alipay/v3/client_test.go
import (
"github.com/go-pay/gopay/alipay/v3"
"github.com/go-pay/xlog"
)
// 初始化支付宝客V3户端
// appid：应用ID
// privateKey：应用私钥，支持PKCS1和PKCS8
// isProd：是否是正式环境，沙箱环境请选择新版沙箱应用。
client, err := alipay.NewClientV3("2016091200494382", privateKey, false)
if err != nil {
xlog.Error(err)
return
}
// 自定义配置http请求接收返回结果body大小，默认 10MB
client.SetBodySize() // 没有特殊需求，可忽略此配置
// 设置自定义RequestId生成方法，非必须
client.SetRequestIdFunc()
// 打开Debug开关，输出日志，默认关闭
client.DebugSwitch = gopay.DebugOn
// 设置biz_content加密KEY，设置此参数默认开启加密（目前不可用）
//client.SetAESKey("1234567890123456")
// 传入证书内容
err := client.SetCert("appPublicCert.crt bytes", "alipayRootCert bytes", "alipayPublicCert.crt bytes")具体参数请根据不同接口查看：支付宝V3版API接口文档
- 统一收单线下交易预创建 - 示例
import (
"github.com/go-pay/gopay"
"github.com/go-pay/gopay/pkg/js"
"github.com/go-pay/util"
"github.com/go-pay/xlog"
)
// 请求参数
bm := make(gopay.BodyMap)
bm.Set("subject", "预创建创建订单").
Set("out_trade_no", util.RandomString(32)).
Set("total_amount", "0.01")
// 创建订单
aliRsp, err := client.TradePrecreate(ctx, bm)
if err != nil {
xlog.Errorf("client.TradePrecreate(), err:%v", err)
return
}
xlog.Warnf("aliRsp:%s", js.Marshal(aliRsp))
if aliRsp.StatusCode != Success {
xlog.Errorf("aliRsp.StatusCode:%d", aliRsp.StatusCode)
return
}
xlog.Warnf("aliRsp.QrCode:", aliRsp.QrCode)
xlog.Warnf("aliRsp.OutTradeNo:", aliRsp.OutTradeNo)- 自定义接口调用 - 示例
import (
"github.com/go-pay/gopay"
"github.com/go-pay/gopay/pkg/js"
"github.com/go-pay/util"
"github.com/go-pay/xlog"
)
// 请求参数
bm := make(gopay.BodyMap)
bm.Set("subject", "预创建创建订单").
Set("out_trade_no", util.RandomString(32)).
Set("total_amount", "0.01")
rsp := new(struct {
OutTradeNo string `json:"out_trade_no"`
QrCode string `json:"qr_code"`
})
// 创建订单
res, err := client.DoAliPayAPISelfV3(ctx, alipay.MethodPost, "/v3/alipay/trade/precreate", bm, rsp)
if err != nil {
xlog.Errorf("client.TradePrecreate(), err:%v", err)
return
}
xlog.Warnf("aliRsp:%s", js.Marshal(rsp))
if res.StatusCode != Success {
xlog.Errorf("aliRsp.StatusCode:%d", res.StatusCode)
return
}异步通知请求参数需要先解析，解析出来的结构体或BodyMap再验签（此处需要注意，
http.Request.Body只能解析一次，如果需要解析前调试，请处理好Body复用问题）
支付宝支付后的异步通知验签文档：支付结果通知
- 异步通知验签（复用非V3版方式）
import (
"github.com/go-pay/gopay/alipay"
)
// 解析异步通知的参数
// req：*http.Request
notifyReq, err = alipay.ParseNotifyToBodyMap(c.Request) // c.Request 是 gin 框架的写法
if err != nil {
xlog.Error(err)
return
}
或
// value：url.Values
notifyReq, err = alipay.ParseNotifyByURLValues()
if err != nil {
xlog.Error(err)
return
}
// 支付宝异步通知验签（公钥模式）
ok, err = alipay.VerifySign(aliPayPublicKey, notifyReq)
// 支付宝异步通知验签（公钥证书模式）
ok, err = alipay.VerifySignWithCert("alipayPublicCert.crt content", notifyReq)
// 如果需要，可将 BodyMap 内数据，Unmarshal 到指定结构体指针 ptr
err = notifyReq.Unmarshal(ptr)
// ====异步通知，返回支付宝平台的信息====
// 文档：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")- 支付宝接口自行实现方法：
client.DoAliPayAPISelfV3() - 支付
- 统一收单交易支付接口：
client.TradePay() - 统一收单交易查询：
client.TradeQuery() - 统一收单交易退款接口：
client.TradeRefund() - 统一收单交易退款查询：
client.TradeFastPayRefundQuery() - 统一收单交易撤销接口：
client.TradeCancel() - 统一收单交易关闭接口：
client.TradeClose() - 查询对账单下载地址：
client.DataBillDownloadUrlQuery() - 统一收单线下交易预创建：
client.TradePrecreate() - 统一收单交易创建接口：
client.TradeCreate() - 支付宝订单信息同步接口：
client.TradeOrderInfoSync() - 资金授权操作查询接口：
client.FundAuthOperationDetailQuery() - 资金授权冻结接口：
client.FundAuthOrderFreeze() - 资金授权解冻接口：
client.FundAuthOrderUnfreeze() - 资金授权发码接口：
client.FundAuthOrderVoucherCreate() - 刷脸支付初始化接口：
client.ZolozAuthenticationSmilepayInitialize() - 查询刷脸结果信息接口：
client.ZolozAuthenticationCustomerFtokenQuery()
- 统一收单交易支付接口：
- 商家扣款
- 支付宝个人代扣协议查询接口：
client.UserAgreementQuery() - 支付宝个人代扣协议解约接口：
client.UserAgreementPageUnSign()
- 支付宝个人代扣协议查询接口：
- 商家分账
- 分账关系绑定接口：
client.TradeRelationBind() - 分账关系解绑：
client.TradeRelationUnbind() - 分账关系查询：
client.TradeRelationBatchQuery() - 分账比例查询：
client.TradeRoyaltyRateQuery() - 统一收单交易结算接口：
client.TradeOrderSettle() - 分账剩余金额查询：
client.TradeOrderOnSettleQuery()
- 分账关系绑定接口：
- 会员
- 换取授权访问令牌：
client.SystemOauthToken() - 身份认证记录查询：
client.UserCertifyOpenQuery() - 身份认证初始化服务：
client.UserCertifyOpenInitialize() - 支付宝会员授权信息查询接口：
client.UserInfoShare() - 用户授权关系查询：
client.UserAuthRelationshipQuery() - 查询解除授权明细：
client.UserDelOauthDetailQuery()
- 换取授权访问令牌：
- 人脸认证
- 人脸核身初始化：
client.FaceVerificationInitialize() - 人脸核身结果查询：
client.FaceVerificationQuery() - 跳转支付宝人脸核身初始化：
client.FaceCertifyInitialize() - 跳转支付宝人脸核身开始认证：
client.FaceCertifyVerify() - 跳转支付宝人脸核身查询记录：
client.FaceCertifyQuery() - 纯服务端人脸核身：
client.FaceSourceCertify() - 活体检测初始化：
client.FaceCheckInitialize() - 活体检测结果查询：
client.FaceCheckQuery() - 身份证二要素核验：
client.IDCardTwoMetaCheck() - 银行卡核验：
client.BankCardCheck() - 手机号三要素核验简版：
client.MobileThreeMetaSimpleCheck() - 手机号三要素核验详版：
client.MobileThreeMetaDetailCheck() - 服务端OCR：
client.OcrServerDetect() - App端OCR初始化：
client.OcrMobileInitialize()
- 人脸核身初始化：