global-open-sdk-python 1.6.0__tar.gz → 1.6.1__tar.gz

{global_open_sdk_python-1.6.0 → global_open_sdk_python-1.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: global-open-sdk-python
-Version: 1.6.0
+Version: 1.6.1
 Summary: The global alipay gateway SDK for Python.
 Home-page: https://github.com/alipay/global-open-sdk-python
 Author: guodong.wzj

{global_open_sdk_python-1.6.0 → global_open_sdk_python-1.6.1}/README.md

@@ -1,7 +1,7 @@
 ```
 Language：Python  
 Python version：2.7+  
-Release ^1.6.0
+Release ^1.6.1
 Copyright：Ant financial services group  
 ```
 

{global_open_sdk_python-1.6.0 → global_open_sdk_python-1.6.1}/com/alipay/ams/api/_version.py

@@ -1,2 +1,2 @@
-VERSION = "1.6.0"
+VERSION = "1.6.1"
 USER_AGENT = "global-open-sdk-python/" + VERSION

{global_open_sdk_python-1.6.0 → global_open_sdk_python-1.6.1}/com/alipay/ams/api/default_alipay_client.py

@@ -1,11 +1,16 @@
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
+import json
+
 from com.alipay.ams.api._version import USER_AGENT
 from com.alipay.ams.api.tools.signature_tool import *
 from com.alipay.ams.api.tools.date_tools import *
 from com.alipay.ams.api.net.default_http_rpc import *
-from com.alipay.ams.api.request_transport_resolver import requires_session_http2
+from com.alipay.ams.api.request_transport_resolver import (
+    requires_session_http2,
+    allows_unsigned_response,
+)
 
 
 class DefaultAlipayClient(object):
@@ -88,6 +93,36 @@ class DefaultAlipayClient(object):
             raise AlipayApiException("response verify failed. " + str(e))
         return is_verify
 
+    def __assert_response_verified(
+        self, http_method, path, client_id, response_time, rsp_body, rsp_signature
+    ):
+        signature_missing = not rsp_signature
+        response_time_missing = not response_time
+        if signature_missing and response_time_missing:
+            result_status = None
+            try:
+                result = json.loads(rsp_body).get("result") or {}
+                result_status = result.get("resultStatus")
+            except Exception:
+                result_status = None
+            if result_status in ("F", "U"):
+                return
+            raise AlipayApiException(
+                "response data error, unsigned response with resultStatus="
+                + str(result_status)
+                + " is not accepted."
+            )
+        if signature_missing or response_time_missing:
+            raise AlipayApiException(
+                "response data error, incomplete signature headers."
+            )
+
+        is_verify = self.__verify_sign(
+            http_method, path, client_id, response_time, rsp_body, rsp_signature
+        )
+        if not is_verify:
+            raise AlipayApiException("response signature verify failed.")
+
     def __parse_header(self, headers):
         for item in headers:
             header_key = item[0]
@@ -119,8 +154,10 @@ class DefaultAlipayClient(object):
 
         client_id = self.__client_id
         self.__is_sandbox_mode = client_id.startswith("SANDBOX_")
-        self.adjust_sandbox_url(request)
         http_method = request.http_method.value
+        # evaluate before adjust_sandbox_url rewrites the path, so the original route is matched
+        allow_unsigned_response = allows_unsigned_response(http_method, request.path)
+        self.adjust_sandbox_url(request)
         path = request.path
         req_time = get_cur_iso8601_time()
         req_body = request.to_ams_json()
@@ -152,15 +189,13 @@ class DefaultAlipayClient(object):
 
         rsp_body = response.decode(DEFAULT_CHARSET)
 
-        rsp_signature, response_time, client_id = self.__parse_header(headers)
-        if not rsp_signature or not response_time:
+        if allow_unsigned_response:
             return rsp_body
 
-        is_verify = self.__verify_sign(
+        rsp_signature, response_time, client_id = self.__parse_header(headers)
+        self.__assert_response_verified(
             http_method, path, client_id, response_time, rsp_body, rsp_signature
         )
-        if not is_verify:
-            raise AlipayApiException("response signature verify failed.")
 
         return rsp_body
 
@@ -192,6 +227,8 @@ class DefaultAlipayClient(object):
 
         client_id = self.__client_id
         self.__is_sandbox_mode = client_id.startswith("SANDBOX_")
+        # evaluate before adjust_sandbox_url rewrites the path, so the original route is matched
+        allow_unsigned_response = allows_unsigned_response(http_method, request.path)
         self.adjust_sandbox_url(request)
         path = request.path
         req_time = get_cur_iso8601_time()
@@ -231,15 +268,13 @@ class DefaultAlipayClient(object):
 
         rsp_body = response.decode(DEFAULT_CHARSET)
 
-        rsp_signature, response_time, client_id = self.__parse_header(headers)
-        if not rsp_signature or not response_time:
+        if allow_unsigned_response:
             return rsp_body
 
-        is_verify = self.__verify_sign(
+        rsp_signature, response_time, client_id = self.__parse_header(headers)
+        self.__assert_response_verified(
             http_method, path, client_id, response_time, rsp_body, rsp_signature
         )
-        if not is_verify:
-            raise AlipayApiException("response signature verify failed.")
 
         return rsp_body
 

{global_open_sdk_python-1.6.0 → global_open_sdk_python-1.6.1}/com/alipay/ams/api/model/applicability.py

@@ -13,7 +13,7 @@ class Applicability:
     @property
     def scope(self):
         """
-        The scope. Maximum length: 8 characters.
+        The applicability scope. Valid values are ALL and SPECIFIC. ALL applies the Credit Grant to all eligible Prices that use the same currency as the Grant and omits priceIds; SPECIFIC applies it only to the Prices specified by priceIds. Maximum length: 8 characters.
         """
         return self.__scope
 
@@ -23,7 +23,7 @@ class Applicability:
     @property
     def price_ids(self):
         """
-        The price ids. Note: See documentation for details.
+        The Price IDs that the Credit Grant applies to. Required when scope is SPECIFIC and values must be unique; omitted when scope is ALL. Maximum size: 64 elements. Maximum length per item: 64 characters.
         """
         return self.__price_ids
 

{global_open_sdk_python-1.6.0 → global_open_sdk_python-1.6.1}/com/alipay/ams/api/model/credit_grant.py

@@ -1,6 +1,6 @@
 import json
 from com.alipay.ams.api.model.amount import Amount
-from com.alipay.ams.api.model.available_amount import AvailableAmount
+from com.alipay.ams.api.model.amount import Amount
 from com.alipay.ams.api.model.applicability import Applicability
 
 
@@ -14,7 +14,7 @@ class CreditGrant:
         self.__customer_id = None  # type: str
         self.__status = None  # type: str
         self.__amount = None  # type: Amount
-        self.__available_amount = None  # type: AvailableAmount
+        self.__available_amount = None  # type: Amount
         self.__applicability = None  # type: Applicability
         self.__priority = None  # type: int
         self.__category = None  # type: str
@@ -27,7 +27,7 @@ class CreditGrant:
     @property
     def credit_grant_id(self):
         """
-        The credit grant ID. Maximum length: 64 characters.
+        The unique identifier of the Credit Grant. Maximum length: 64 characters.
         """
         return self.__credit_grant_id
 
@@ -37,7 +37,7 @@ class CreditGrant:
     @property
     def credit_grant_name(self):
         """
-        The credit grant name. Maximum length: 255 characters.
+        The merchant-facing name of the Credit Grant. Maximum length: 255 characters.
         """
         return self.__credit_grant_name
 
@@ -47,7 +47,7 @@ class CreditGrant:
     @property
     def customer_id(self):
         """
-        The unique ID assigned by Antom to identify a customer. Maximum length: 64 characters.
+        The Customer that receives the credit. Maximum length: 64 characters.
         """
         return self.__customer_id
 
@@ -57,7 +57,7 @@ class CreditGrant:
     @property
     def status(self):
         """
-        The current status. Maximum length: 8 characters.
+        The Credit Grant status. Valid values are PENDING, ACTIVE, EXPIRED, and VOIDED. VOIDED is the only irreversible terminal state. Maximum length: 8 characters.
         """
         return self.__status
 
@@ -97,7 +97,7 @@ class CreditGrant:
     @property
     def priority(self):
         """
-        The priority.
+        The application priority from 0 to 100. A lower value has a higher priority.
         """
         return self.__priority
 
@@ -107,7 +107,7 @@ class CreditGrant:
     @property
     def category(self):
         """
-        The category. Maximum length: 16 characters.
+        The Credit Grant category. Valid values are PREPAID and PROMOTIONAL. Maximum length: 16 characters.
         """
         return self.__category
 
@@ -117,7 +117,7 @@ class CreditGrant:
     @property
     def effective_date_time(self):
         """
-        The effective date time. Maximum length: 32 characters. Note: See documentation for details.
+        The effective time in ISO 8601 UTC format, encoded as a JSON string. Omitted when the Grant is effective immediately. Maximum length: 32 characters.
         """
         return self.__effective_date_time
 
@@ -127,7 +127,7 @@ class CreditGrant:
     @property
     def expiry_date_time(self):
         """
-        The expiry date time. Maximum length: 32 characters. Note: See documentation for details.
+        The expiration time in ISO 8601 UTC format, encoded as a JSON string. Omitted when the Grant does not expire automatically. Maximum length: 32 characters.
         """
         return self.__expiry_date_time
 
@@ -137,7 +137,7 @@ class CreditGrant:
     @property
     def created_date_time(self):
         """
-        The created date time. Maximum length: 32 characters.
+        The creation time in ISO 8601 UTC format, encoded as a JSON string. Maximum length: 32 characters.
         """
         return self.__created_date_time
 
@@ -147,7 +147,7 @@ class CreditGrant:
     @property
     def updated_date_time(self):
         """
-        The updated date time. Maximum length: 32 characters.
+        The last update time in ISO 8601 UTC format, encoded as a JSON string. Maximum length: 32 characters.
         """
         return self.__updated_date_time
 
@@ -204,7 +204,7 @@ class CreditGrant:
             self.__amount = Amount()
             self.__amount.parse_rsp_body(response_body['amount'])
         if 'availableAmount' in response_body:
-            self.__available_amount = AvailableAmount()
+            self.__available_amount = Amount()
             self.__available_amount.parse_rsp_body(response_body['availableAmount'])
         if 'applicability' in response_body:
             self.__applicability = Applicability()

{global_open_sdk_python-1.6.0 → global_open_sdk_python-1.6.1}/com/alipay/ams/api/model/meter.py

@@ -20,7 +20,7 @@ class Meter:
     @property
     def meter_id(self):
         """
-        The meter ID. Maximum length: 64 characters.
+        The unique identifier of the Meter. Maximum length: 64 characters.
         """
         return self.__meter_id
 
@@ -30,7 +30,7 @@ class Meter:
     @property
     def meter_name(self):
         """
-        The meter name. Maximum length: 255 characters.
+        The merchant-facing name of the Meter. Maximum length: 255 characters.
         """
         return self.__meter_name
 
@@ -40,7 +40,7 @@ class Meter:
     @property
     def event_name(self):
         """
-        The event name. Maximum length: 100 characters.
+        The event routing name. It is unique within a merchant and cannot be changed after creation. Maximum length: 100 characters.
         """
         return self.__event_name
 
@@ -50,7 +50,7 @@ class Meter:
     @property
     def status(self):
         """
-        The current status. Maximum length: 8 characters.
+        The Meter status. Valid values are ACTIVE and INACTIVE. Maximum length: 8 characters.
         """
         return self.__status
 
@@ -60,7 +60,7 @@ class Meter:
     @property
     def aggregation_method(self):
         """
-        The aggregation method. Maximum length: 8 characters.
+        The aggregation method. Valid values are SUM, COUNT, and LAST. SUM adds the metered values from all eligible Events within the aggregation period; COUNT counts the number of eligible Events within the aggregation period; LAST uses the metered value from the most recent eligible Event. Maximum length: 8 characters.
         """
         return self.__aggregation_method
 
@@ -70,7 +70,7 @@ class Meter:
     @property
     def event_time_window(self):
         """
-        The event time window. Maximum length: 4 characters.
+        The upstream pre-aggregation window. Valid values are HOUR and DAY. The field is omitted for raw Events. Maximum length: 4 characters.
         """
         return self.__event_time_window
 
@@ -80,7 +80,7 @@ class Meter:
     @property
     def value_key_override(self):
         """
-        The value key override. Maximum length: 256 characters.
+        The field name in the Event payload that contains the metered value. Its length is 1 to 100 characters and it must match ^[A-Za-z0-9_]{1,100}$. Maximum length: 100 characters.
         """
         return self.__value_key_override
 
@@ -90,7 +90,7 @@ class Meter:
     @property
     def created_date_time(self):
         """
-        The created date time. Maximum length: 32 characters.
+        The creation time in ISO 8601 UTC format, encoded as a JSON string. Maximum length: 32 characters.
         """
         return self.__created_date_time
 
@@ -100,7 +100,7 @@ class Meter:
     @property
     def updated_date_time(self):
         """
-        The updated date time. Maximum length: 32 characters.
+        The last update time in ISO 8601 UTC format, encoded as a JSON string. Maximum length: 32 characters.
         """
         return self.__updated_date_time
 

global_open_sdk_python-1.6.1/com/alipay/ams/api/model/pop_risk_decision_result_info.py

@@ -0,0 +1,67 @@
+import json
+
+
+
+
+class PopRiskDecisionResultInfo:
+    def __init__(self):
+        
+        self.__risk_auth_decision = None  # type: str
+        self.__risk_decision = None  # type: str
+        self.__post_risk_decision = None  # type: str
+        
+
+    @property
+    def risk_auth_decision(self):
+        """
+        The risk decision that is related to the authorization of the payment.
+        """
+        return self.__risk_auth_decision
+
+    @risk_auth_decision.setter
+    def risk_auth_decision(self, value):
+        self.__risk_auth_decision = value
+    @property
+    def risk_decision(self):
+        """
+        The risk decision for the payment.
+        """
+        return self.__risk_decision
+
+    @risk_decision.setter
+    def risk_decision(self, value):
+        self.__risk_decision = value
+    @property
+    def post_risk_decision(self):
+        """
+        The post-authorization risk decision result. Valid values are:  ACCEPT: The post-authorization risk review is passed. The merchant can continue to capture the payment or fulfill the order. REVIEW: The post-authorization risk review recommends a manual review. REJECT: The post-authorization risk review is rejected. Cancel the order.  Note: This field is returned when the merchant calls the post-authorization risk review interface and the interface returns a non-empty result within the time limit. When the interface times out, returns null, or is not called, this field is not returned and no post-authorization risk review is deemed to have occurred.  More information:  Maximum length: 6 characters
+        """
+        return self.__post_risk_decision
+
+    @post_risk_decision.setter
+    def post_risk_decision(self, value):
+        self.__post_risk_decision = value
+
+
+    
+
+    def to_ams_dict(self):
+        params = dict()
+        if hasattr(self, "risk_auth_decision") and self.risk_auth_decision is not None:
+            params['riskAuthDecision'] = self.risk_auth_decision
+        if hasattr(self, "risk_decision") and self.risk_decision is not None:
+            params['riskDecision'] = self.risk_decision
+        if hasattr(self, "post_risk_decision") and self.post_risk_decision is not None:
+            params['postRiskDecision'] = self.post_risk_decision
+        return params
+
+
+    def parse_rsp_body(self, response_body):
+        if isinstance(response_body, str): 
+            response_body = json.loads(response_body)
+        if 'riskAuthDecision' in response_body:
+            self.__risk_auth_decision = response_body['riskAuthDecision']
+        if 'riskDecision' in response_body:
+            self.__risk_decision = response_body['riskDecision']
+        if 'postRiskDecision' in response_body:
+            self.__post_risk_decision = response_body['postRiskDecision']

global_open_sdk_python-1.6.1/com/alipay/ams/api/model/split_detail.py

@@ -0,0 +1,86 @@
+import json
+from com.alipay.ams.api.model.amount import Amount
+from com.alipay.ams.api.model.amount import Amount
+
+
+
+
+class SplitDetail:
+    def __init__(self):
+        
+        self.__split_to = None  # type: str
+        self.__split_amount = None  # type: Amount
+        self.__actual_split_amount = None  # type: Amount
+        self.__description = None  # type: str
+        
+
+    @property
+    def split_to(self):
+        """
+        The original split recipient from which the funds are reversed for this refund. Valid values are:  SELLER: indicates that the payment funds were split to the seller. MARKETPLACE: indicates that the payment funds were split to the marketplace. PLATFORM: indicates that the payment funds were split to the platform. ISV: indicates that the payment funds were split to the independent software vendor.  Note: The value must exist in the successful split of the original payment or capture. Unknown values are rejected with the existing PARAM_ILLEGAL behavior.  More information:  Maximum length: 32 characters
+        """
+        return self.__split_to
+
+    @split_to.setter
+    def split_to(self, value):
+        self.__split_to = value
+    @property
+    def split_amount(self):
+        """Gets the split_amount of this SplitDetail.
+        
+        """
+        return self.__split_amount
+
+    @split_amount.setter
+    def split_amount(self, value):
+        self.__split_amount = value
+    @property
+    def actual_split_amount(self):
+        """Gets the actual_split_amount of this SplitDetail.
+        
+        """
+        return self.__actual_split_amount
+
+    @actual_split_amount.setter
+    def actual_split_amount(self, value):
+        self.__actual_split_amount = value
+    @property
+    def description(self):
+        """
+        The merchant-supplied remark for billing and reconciliation. If this field is provided, it is reflected in the bill and returned with the corresponding refund split detail. Omission does not affect refund or split-reversal processing.  More information:  Maximum length: 256 characters
+        """
+        return self.__description
+
+    @description.setter
+    def description(self, value):
+        self.__description = value
+
+
+    
+
+    def to_ams_dict(self):
+        params = dict()
+        if hasattr(self, "split_to") and self.split_to is not None:
+            params['splitTo'] = self.split_to
+        if hasattr(self, "split_amount") and self.split_amount is not None:
+            params['splitAmount'] = self.split_amount
+        if hasattr(self, "actual_split_amount") and self.actual_split_amount is not None:
+            params['actualSplitAmount'] = self.actual_split_amount
+        if hasattr(self, "description") and self.description is not None:
+            params['description'] = self.description
+        return params
+
+
+    def parse_rsp_body(self, response_body):
+        if isinstance(response_body, str): 
+            response_body = json.loads(response_body)
+        if 'splitTo' in response_body:
+            self.__split_to = response_body['splitTo']
+        if 'splitAmount' in response_body:
+            self.__split_amount = Amount()
+            self.__split_amount.parse_rsp_body(response_body['splitAmount'])
+        if 'actualSplitAmount' in response_body:
+            self.__actual_split_amount = Amount()
+            self.__actual_split_amount.parse_rsp_body(response_body['actualSplitAmount'])
+        if 'description' in response_body:
+            self.__description = response_body['description']

{global_open_sdk_python-1.6.0 → global_open_sdk_python-1.6.1}/com/alipay/ams/api/request/billing/alipay_credit_grant_create_request.py

@@ -23,7 +23,7 @@ class AlipayCreditGrantCreateRequest(AlipayRequest):
     @property
     def customer_id(self):
         """
-        The unique ID assigned by Antom to identify a customer. Maximum length: 64 characters.
+        The Customer receiving the credit. The service validates ownership and status. Maximum length: 64 characters.
         """
         return self.__customer_id
 
@@ -33,7 +33,7 @@ class AlipayCreditGrantCreateRequest(AlipayRequest):
     @property
     def credit_grant_name(self):
         """
-        The credit grant name. Maximum length: 255 characters.
+        The merchant-facing name of the Credit Grant. It must not be null, empty, blank, or longer than 255 characters. Maximum length: 255 characters.
         """
         return self.__credit_grant_name
 
@@ -63,7 +63,7 @@ class AlipayCreditGrantCreateRequest(AlipayRequest):
     @property
     def priority(self):
         """
-        The priority.
+        The application priority from 0 to 100. Omit to use 0. A lower value has a higher priority.
         """
         return self.__priority
 
@@ -73,7 +73,7 @@ class AlipayCreditGrantCreateRequest(AlipayRequest):
     @property
     def category(self):
         """
-        The category. Maximum length: 16 characters.
+        The category. Valid values are PREPAID and PROMOTIONAL. Maximum length: 16 characters.
         """
         return self.__category
 
@@ -83,7 +83,7 @@ class AlipayCreditGrantCreateRequest(AlipayRequest):
     @property
     def effective_date_time(self):
         """
-        The effective date time. Maximum length: 32 characters. Note: See documentation for details.
+        The effective time in ISO 8601 UTC format, encoded as a JSON string. Omit for immediate activation; a provided value earlier than server time is accepted only within the clock-skew tolerance. Maximum length: 32 characters.
         """
         return self.__effective_date_time
 
@@ -93,7 +93,7 @@ class AlipayCreditGrantCreateRequest(AlipayRequest):
     @property
     def expiry_date_time(self):
         """
-        The expiry date time. Maximum length: 32 characters. Note: See documentation for details.
+        The expiration time in ISO 8601 UTC format, encoded as a JSON string. Omit for no automatic expiration; otherwise the value must be later than the current and effective times. Maximum length: 32 characters.
         """
         return self.__expiry_date_time
 

{global_open_sdk_python-1.6.0 → global_open_sdk_python-1.6.1}/com/alipay/ams/api/request/billing/alipay_credit_grant_inquire_details_request.py

@@ -14,7 +14,7 @@ class AlipayCreditGrantInquireDetailsRequest(AlipayRequest):
     @property
     def credit_grant_id(self):
         """
-        The credit grant ID. Maximum length: 64 characters.
+        The unique identifier of the Credit Grant. The resource must belong to the authenticated merchant. Maximum length: 64 characters.
         """
         return self.__credit_grant_id
 

{global_open_sdk_python-1.6.0 → global_open_sdk_python-1.6.1}/com/alipay/ams/api/request/billing/alipay_credit_grant_inquire_list_request.py

@@ -17,7 +17,7 @@ class AlipayCreditGrantInquireListRequest(AlipayRequest):
     @property
     def page_num(self):
         """
-        The page number. The value must be at least 1. The default value is 1. A page beyond the last page returns SUCCESS with an empty `creditGrants` array.
+        The page number. Omit to use 1. When present, it must be an integer at least 1; a page beyond the current last page returns success with an empty creditGrants array.
         """
         return self.__page_num
 
@@ -27,7 +27,7 @@ class AlipayCreditGrantInquireListRequest(AlipayRequest):
     @property
     def page_size(self):
         """
-        The number of records per page. Value range: 1-100. The default value is 10.
+        The number of records per page. Omit to use 10. When present, it must be an integer from 1 to 100.
         """
         return self.__page_size
 
@@ -37,7 +37,7 @@ class AlipayCreditGrantInquireListRequest(AlipayRequest):
     @property
     def customer_id(self):
         """
-        The unique ID assigned by Antom to identify a customer. Maximum length: 64 characters.
+        The Customer filter. Omit to include all Customers. Maximum length: 64 characters.
         """
         return self.__customer_id
 
@@ -47,7 +47,7 @@ class AlipayCreditGrantInquireListRequest(AlipayRequest):
     @property
     def status(self):
         """
-        The current status. Maximum length: 8 characters.
+        The Credit Grant status filter. Valid values are PENDING, ACTIVE, EXPIRED, and VOIDED; omit to include all states. Maximum length: 8 characters.
         """
         return self.__status
 

{global_open_sdk_python-1.6.0 → global_open_sdk_python-1.6.1}/com/alipay/ams/api/request/billing/alipay_credit_grant_update_expiry_request.py

@@ -16,7 +16,7 @@ class AlipayCreditGrantUpdateExpiryRequest(AlipayRequest):
     @property
     def credit_grant_id(self):
         """
-        The credit grant ID. Maximum length: 64 characters.
+        The unique identifier of the Credit Grant. The resource must belong to the authenticated merchant. Maximum length: 64 characters.
         """
         return self.__credit_grant_id
 
@@ -26,7 +26,7 @@ class AlipayCreditGrantUpdateExpiryRequest(AlipayRequest):
     @property
     def expiry_mode(self):
         """
-        The expiry mode. Maximum length: 16 characters.
+        The expiration mode. Valid values are NEVER, SPECIFIC_DATE, and IMMEDIATELY. NEVER means the Credit Grant does not expire automatically and expiryDateTime is omitted; SPECIFIC_DATE means the Credit Grant expires at the time specified by expiryDateTime, which is required; IMMEDIATELY means the Credit Grant expires immediately after the request is successfully processed and expiryDateTime is omitted. Maximum length: 16 characters.
         """
         return self.__expiry_mode
 
@@ -36,7 +36,7 @@ class AlipayCreditGrantUpdateExpiryRequest(AlipayRequest):
     @property
     def expiry_date_time(self):
         """
-        The expiry date time. Maximum length: 32 characters. Note: See documentation for details.
+        The expiration time in ISO 8601 UTC format, encoded as a JSON string. Send this field only when expiryMode is SPECIFIC_DATE; otherwise omit. The value must be later than the current and effective times. Maximum length: 32 characters.
         """
         return self.__expiry_date_time
 

{global_open_sdk_python-1.6.0 → global_open_sdk_python-1.6.1}/com/alipay/ams/api/request/billing/alipay_credit_grant_void_request.py

@@ -15,7 +15,7 @@ class AlipayCreditGrantVoidRequest(AlipayRequest):
     @property
     def credit_grant_id(self):
         """
-        The credit grant ID. Maximum length: 64 characters.
+        The unique identifier of the Credit Grant. The resource must belong to the authenticated merchant. Maximum length: 64 characters.
         """
         return self.__credit_grant_id
 
@@ -25,7 +25,7 @@ class AlipayCreditGrantVoidRequest(AlipayRequest):
     @property
     def void_reason(self):
         """
-        The void reason. Maximum length: 1024 characters.
+        The business reason for voiding. Send a non-blank reason only when the business workflow requires the reason to be retained; omit when no audit reason exists. Maximum length: 1024 characters.
         """
         return self.__void_reason