v1.5.87

Author: iGoogle-ink

alipay/common_api.go

@@ -115,9 +115,14 @@ func DecryptOpenDataToBodyMap(encryptedData, secretKey string) (bm gopay.BodyMap
 // grantType：值为 authorization_code 时，代表用code换取；值为 refresh_token 时，代表用refresh_token换取，传空默认code换取
 // codeOrToken：支付宝授权码或refresh_token
 // signType：签名方式 RSA 或 RSA2，默认 RSA2
+// appAuthToken：可选参数，三方授权令牌
 // 文档：https://opendocs.alipay.com/apis/api_9/alipay.system.oauth.token
-func SystemOauthToken(ctx context.Context, appId string, privateKey, grantType, codeOrToken, signType string) (rsp *SystemOauthTokenResponse, err error) {
+func SystemOauthToken(ctx context.Context, appId string, privateKey, grantType, codeOrToken, signType string, appAuthToken ...string) (rsp *SystemOauthTokenResponse, err error) {
 	key := xrsa.FormatAlipayPrivateKey(privateKey)
+	aat := ""
+	if len(appAuthToken) > 0 {
+		aat = appAuthToken[0]
+	}
 	priKey, err := xpem.DecodePrivateKey([]byte(key))
 	if err != nil {
 		return nil, err
@@ -135,7 +140,7 @@ func SystemOauthToken(ctx context.Context, appId string, privateKey, grantType,
 		bm.Set("grant_type", "authorization_code")
 		bm.Set("code", codeOrToken)
 	}
-	if bs, err = systemOauthToken(ctx, appId, priKey, bm, "alipay.system.oauth.token", true, signType); err != nil {
+	if bs, err = systemOauthToken(ctx, appId, priKey, bm, "alipay.system.oauth.token", true, signType, aat); err != nil {
 		return
 	}
 	rsp = new(SystemOauthTokenResponse)
@@ -149,7 +154,7 @@ func SystemOauthToken(ctx context.Context, appId string, privateKey, grantType,
 }
 
 // systemOauthToken 向支付宝发送请求
-func systemOauthToken(ctx context.Context, appId string, privateKey *rsa.PrivateKey, bm gopay.BodyMap, method string, isProd bool, signType string) (bs []byte, err error) {
+func systemOauthToken(ctx context.Context, appId string, privateKey *rsa.PrivateKey, bm gopay.BodyMap, method string, isProd bool, signType, appAuthToken string) (bs []byte, err error) {
 	bm.Set("app_id", appId)
 	bm.Set("method", method)
 	bm.Set("format", "JSON")
@@ -161,6 +166,9 @@ func systemOauthToken(ctx context.Context, appId string, privateKey *rsa.Private
 	}
 	bm.Set("timestamp", time.Now().Format(util.TimeLayout))
 	bm.Set("version", "1.0")
+	if appAuthToken != util.NULL {
+		bm.Set("app_auth_token", appAuthToken)
+	}
 	var (
 		sign    string
 		baseUrl = baseUrlUtf8

alipay/util_api.go

@@ -44,20 +44,28 @@ func (a *Client) SystemOauthToken(ctx context.Context, bm gopay.BodyMap) (aliRsp
 	if bm.GetString("code") == util.NULL && bm.GetString("refresh_token") == util.NULL {
 		return nil, errors.New("code and refresh_token are not allowed to be null at the same time")
 	}
-	err = bm.CheckEmptyError("grant_type")
-	if err != nil {
+	if err = bm.CheckEmptyError("grant_type"); err != nil {
 		return nil, err
 	}
-
+	var (
+		bs  []byte
+		aat string
+	)
 	if a.AppCertSN != util.NULL {
 		bm.Set("app_cert_sn", a.AppCertSN)
 	}
 	if a.AliPayRootCertSN != util.NULL {
 		bm.Set("alipay_root_cert_sn", a.AliPayRootCertSN)
 	}
-
-	var bs []byte
-	if bs, err = systemOauthToken(ctx, a.AppId, a.privateKey, bm, "alipay.system.oauth.token", a.IsProd, a.SignType); err != nil {
+	// default use app_auth_token
+	if a.AppAuthToken != util.NULL {
+		aat = a.AppAuthToken
+	}
+	// if user set app_auth_token in body_map, use this
+	if bmAt := bm.GetString("app_auth_token"); bmAt != util.NULL {
+		aat = bmAt
+	}
+	if bs, err = systemOauthToken(ctx, a.AppId, a.privateKey, bm, "alipay.system.oauth.token", a.IsProd, a.SignType, aat); err != nil {
 		return nil, err
 	}
 	aliRsp = new(SystemOauthTokenResponse)

release_note.txt

@@ -3,6 +3,7 @@
    (1) 微信V3：新增小程序调起支付分所需要的支付参数方法：client.PaySignOfAppletScore()。
    (2) 微信V3：异步通知解析方法接收BodySize大小调至5MB。
    (3) 支付宝：统一收单交易退款接口，response补充接收字段。
+   (4) 支付宝：alipay.SystemOauthToken() 接口增加可变参数 AppAuthToken 字段，如需要时可传。
 
 版本号：Release 1.5.86
 修改记录：