global-open-sdk-python 1.7.2__tar.gz → 1.7.3__tar.gz

{global_open_sdk_python-1.7.2 → global_open_sdk_python-1.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: global-open-sdk-python
-Version: 1.7.2
+Version: 1.7.3
 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.7.2 → global_open_sdk_python-1.7.3}/README.md

@@ -1,6 +1,6 @@
 # Antom SDK for Python
 
-Latest release: **1.7.2**
+Latest release: **1.7.3**
 
 ## Installation
 

{global_open_sdk_python-1.7.2 → global_open_sdk_python-1.7.3}/com/alipay/ams/api/_version.py

@@ -1,2 +1,2 @@
-VERSION = "1.7.2"
+VERSION = "1.7.3"
 USER_AGENT = "global-open-sdk-python/" + VERSION

global_open_sdk_python-1.7.3/com/alipay/ams/api/model/inquire_payment_method_card.py

@@ -0,0 +1,176 @@
+import json
+from com.alipay.ams.api.model.user_name import UserName
+from com.alipay.ams.api.model.address import Address
+
+
+
+
+class InquirePaymentMethodCard:
+    def __init__(self):
+        
+        self.__card_token = None  # type: str
+        self.__card_no = None  # type: str
+        self.__mask = None  # type: str
+        self.__brand = None  # type: str
+        self.__country_issue = None  # type: str
+        self.__card_issuer = None  # type: str
+        self.__expiry_month = None  # type: str
+        self.__expiry_year = None  # type: str
+        self.__inst_user_name = None  # type: UserName
+        self.__billing_address = None  # type: Address
+        
+
+    @property
+    def card_token(self):
+        """
+        The card token, consistent with the request.
+        """
+        return self.__card_token
+
+    @card_token.setter
+    def card_token(self, value):
+        self.__card_token = value
+    @property
+    def card_no(self):
+        """
+        The full bank card number (PAN). This is the core capability of this API.
+        """
+        return self.__card_no
+
+    @card_no.setter
+    def card_no(self, value):
+        self.__card_no = value
+    @property
+    def mask(self):
+        """
+        The masked card number, for example 411734******7890.
+        """
+        return self.__mask
+
+    @mask.setter
+    def mask(self, value):
+        self.__mask = value
+    @property
+    def brand(self):
+        """
+        The card brand, for example VISA or MASTER. Queried in real time from the card BIN.
+        """
+        return self.__brand
+
+    @brand.setter
+    def brand(self, value):
+        self.__brand = value
+    @property
+    def country_issue(self):
+        """
+        The issuing country or region as a two-letter country code. Queried in real time from the card BIN.
+        """
+        return self.__country_issue
+
+    @country_issue.setter
+    def country_issue(self, value):
+        self.__country_issue = value
+    @property
+    def card_issuer(self):
+        """
+        The card issuer name from the stored card binding. Returned only when a value exists; the field is absent when no value is available.
+        """
+        return self.__card_issuer
+
+    @card_issuer.setter
+    def card_issuer(self, value):
+        self.__card_issuer = value
+    @property
+    def expiry_month(self):
+        """
+        The card expiry month as two digits, from the stored card binding.
+        """
+        return self.__expiry_month
+
+    @expiry_month.setter
+    def expiry_month(self, value):
+        self.__expiry_month = value
+    @property
+    def expiry_year(self):
+        """
+        The card expiry year as two digits, from the stored card binding.
+        """
+        return self.__expiry_year
+
+    @expiry_year.setter
+    def expiry_year(self, value):
+        self.__expiry_year = value
+    @property
+    def inst_user_name(self):
+        """Gets the inst_user_name of this InquirePaymentMethodCard.
+        
+        """
+        return self.__inst_user_name
+
+    @inst_user_name.setter
+    def inst_user_name(self, value):
+        self.__inst_user_name = value
+    @property
+    def billing_address(self):
+        """Gets the billing_address of this InquirePaymentMethodCard.
+        
+        """
+        return self.__billing_address
+
+    @billing_address.setter
+    def billing_address(self, value):
+        self.__billing_address = value
+
+
+    
+
+    def to_ams_dict(self):
+        params = dict()
+        if hasattr(self, "card_token") and self.card_token is not None:
+            params['cardToken'] = self.card_token
+        if hasattr(self, "card_no") and self.card_no is not None:
+            params['cardNo'] = self.card_no
+        if hasattr(self, "mask") and self.mask is not None:
+            params['mask'] = self.mask
+        if hasattr(self, "brand") and self.brand is not None:
+            params['brand'] = self.brand
+        if hasattr(self, "country_issue") and self.country_issue is not None:
+            params['countryIssue'] = self.country_issue
+        if hasattr(self, "card_issuer") and self.card_issuer is not None:
+            params['cardIssuer'] = self.card_issuer
+        if hasattr(self, "expiry_month") and self.expiry_month is not None:
+            params['expiryMonth'] = self.expiry_month
+        if hasattr(self, "expiry_year") and self.expiry_year is not None:
+            params['expiryYear'] = self.expiry_year
+        if hasattr(self, "inst_user_name") and self.inst_user_name is not None:
+            params['instUserName'] = self.inst_user_name
+        if hasattr(self, "billing_address") and self.billing_address is not None:
+            params['billingAddress'] = self.billing_address
+        return params
+
+
+    def parse_rsp_body(self, response_body):
+        if isinstance(response_body, str): 
+            response_body = json.loads(response_body)
+        if 'cardToken' in response_body:
+            self.__card_token = response_body['cardToken']
+        if 'cardNo' in response_body:
+            self.__card_no = response_body['cardNo']
+        if 'mask' in response_body:
+            self.__mask = response_body['mask']
+        if 'brand' in response_body:
+            self.__brand = response_body['brand']
+        if 'countryIssue' in response_body:
+            self.__country_issue = response_body['countryIssue']
+        if 'cardIssuer' in response_body:
+            self.__card_issuer = response_body['cardIssuer']
+        if 'expiryMonth' in response_body:
+            self.__expiry_month = response_body['expiryMonth']
+        if 'expiryYear' in response_body:
+            self.__expiry_year = response_body['expiryYear']
+        if 'instUserName' in response_body:
+            self.__inst_user_name = UserName()
+            self.__inst_user_name.parse_rsp_body(response_body['instUserName'])
+        if 'billingAddress' in response_body:
+            self.__billing_address = Address()
+            self.__billing_address.parse_rsp_body(response_body['billingAddress'])

global_open_sdk_python-1.7.3/com/alipay/ams/api/model/inquire_payment_method_detail.py

@@ -0,0 +1,54 @@
+import json
+from com.alipay.ams.api.model.inquire_payment_method_card import InquirePaymentMethodCard
+
+
+
+
+class InquirePaymentMethodDetail:
+    def __init__(self):
+        
+        self.__payment_method_detail_type = None  # type: str
+        self.__card = None  # type: InquirePaymentMethodCard
+        
+
+    @property
+    def payment_method_detail_type(self):
+        """
+        The payment method detail type. The value is CARD; only credit card assets are supported.
+        """
+        return self.__payment_method_detail_type
+
+    @payment_method_detail_type.setter
+    def payment_method_detail_type(self, value):
+        self.__payment_method_detail_type = value
+    @property
+    def card(self):
+        """Gets the card of this InquirePaymentMethodDetail.
+        
+        """
+        return self.__card
+
+    @card.setter
+    def card(self, value):
+        self.__card = value
+
+
+    
+
+    def to_ams_dict(self):
+        params = dict()
+        if hasattr(self, "payment_method_detail_type") and self.payment_method_detail_type is not None:
+            params['paymentMethodDetailType'] = self.payment_method_detail_type
+        if hasattr(self, "card") and self.card is not None:
+            params['card'] = self.card
+        return params
+
+
+    def parse_rsp_body(self, response_body):
+        if isinstance(response_body, str): 
+            response_body = json.loads(response_body)
+        if 'paymentMethodDetailType' in response_body:
+            self.__payment_method_detail_type = response_body['paymentMethodDetailType']
+        if 'card' in response_body:
+            self.__card = InquirePaymentMethodCard()
+            self.__card.parse_rsp_body(response_body['card'])

{global_open_sdk_python-1.7.2 → global_open_sdk_python-1.7.3}/com/alipay/ams/api/model/payment_method.py

@@ -14,6 +14,7 @@ class PaymentMethod:
         self.__extend_info = None  # type: str
         self.__require_issuer_authentication = None  # type: bool
         self.__payment_method_meta_data = None  # type: {str: ({str: (bool, date, datetime, dict, float, int, list, str, none_type)},)}
+        self.__card_brand = None  # type: str
         
 
     @property
@@ -86,6 +87,16 @@ class PaymentMethod:
     @payment_method_meta_data.setter
     def payment_method_meta_data(self, value):
         self.__payment_method_meta_data = value
+    @property
+    def card_brand(self):
+        """
+        The card brand returned for card subscription payments, or UNKNOWN if it cannot be determined.
+        """
+        return self.__card_brand
+
+    @card_brand.setter
+    def card_brand(self, value):
+        self.__card_brand = value
 
 
     
@@ -106,6 +117,8 @@ class PaymentMethod:
             params['requireIssuerAuthentication'] = self.require_issuer_authentication
         if hasattr(self, "payment_method_meta_data") and self.payment_method_meta_data is not None:
             params['paymentMethodMetaData'] = self.payment_method_meta_data
+        if hasattr(self, "card_brand") and self.card_brand is not None:
+            params['cardBrand'] = self.card_brand
         return params
 
 
@@ -127,3 +140,5 @@ class PaymentMethod:
             self.__require_issuer_authentication = response_body['requireIssuerAuthentication']
         if 'paymentMethodMetaData' in response_body:
             self.__payment_method_meta_data = response_body['paymentMethodMetaData']
+        if 'cardBrand' in response_body:
+            self.__card_brand = response_body['cardBrand']

{global_open_sdk_python-1.7.2 → global_open_sdk_python-1.7.3}/com/alipay/ams/api/model/payment_method_detail.py

@@ -5,6 +5,7 @@ from com.alipay.ams.api.model.external_payment_method_detail import ExternalPaym
 from com.alipay.ams.api.model.discount_payment_method_detail import DiscountPaymentMethodDetail
 from com.alipay.ams.api.model.coupon_payment_method_detail import CouponPaymentMethodDetail
 from com.alipay.ams.api.model.wallet import Wallet
+from com.alipay.ams.api.model.payment_method_meta_data import PaymentMethodMetaData
 
 
 
@@ -21,6 +22,7 @@ class PaymentMethodDetail:
         self.__extend_info = None  # type: str
         self.__wallet = None  # type: Wallet
         self.__interaction_type = None  # type: str
+        self.__payment_method_meta_data = None  # type: PaymentMethodMetaData
         
 
     @property
@@ -76,7 +78,7 @@ class PaymentMethodDetail:
     @property
     def payment_method_type(self):
         """
-        The type of payment method to be vaulted. The value of this parameter is fixed to CARD.    More information:  Maximum length: 64 characters 
+        The type of payment method to be vaulted. The value of this parameter is fixed to CARD.    More information:  Maximum length: 64 characters
         """
         return self.__payment_method_type
 
@@ -113,6 +115,15 @@ class PaymentMethodDetail:
     @interaction_type.setter
     def interaction_type(self, value):
         self.__interaction_type = value
+    @property
+    def payment_method_meta_data(self):
+        """Gets the payment_method_meta_data of this PaymentMethodDetail.
+        """
+        return self.__payment_method_meta_data
+
+    @payment_method_meta_data.setter
+    def payment_method_meta_data(self, value):
+        self.__payment_method_meta_data = value
 
 
     
@@ -137,6 +148,8 @@ class PaymentMethodDetail:
             params['wallet'] = self.wallet
         if hasattr(self, "interaction_type") and self.interaction_type is not None:
             params['interactionType'] = self.interaction_type
+        if hasattr(self, "payment_method_meta_data") and self.payment_method_meta_data is not None:
+            params['paymentMethodMetaData'] = self.payment_method_meta_data
         return params
 
 
@@ -167,3 +180,6 @@ class PaymentMethodDetail:
             self.__wallet.parse_rsp_body(response_body['wallet'])
         if 'interactionType' in response_body:
             self.__interaction_type = response_body['interactionType']
+        if 'paymentMethodMetaData' in response_body:
+            self.__payment_method_meta_data = PaymentMethodMetaData()
+            self.__payment_method_meta_data.parse_rsp_body(response_body['paymentMethodMetaData'])

global_open_sdk_python-1.7.3/com/alipay/ams/api/model/payment_method_meta_data.py

@@ -0,0 +1,37 @@
+import json
+
+
+
+
+class PaymentMethodMetaData:
+    def __init__(self):
+        
+        self.__recurring_type = None  # type: str
+        
+
+    @property
+    def recurring_type(self):
+        """
+        The recurring type of subsequent deductions on the vaulted card: SCHEDULED for fixed-schedule deductions or UNSCHEDULED for on-demand deductions. Optional; if omitted, no recurring type is declared, and any other value returns PARAM_ILLEGAL.
+        """
+        return self.__recurring_type
+
+    @recurring_type.setter
+    def recurring_type(self, value):
+        self.__recurring_type = value
+
+
+    
+
+    def to_ams_dict(self):
+        params = dict()
+        if hasattr(self, "recurring_type") and self.recurring_type is not None:
+            params['recurringType'] = self.recurring_type
+        return params
+
+
+    def parse_rsp_body(self, response_body):
+        if isinstance(response_body, str): 
+            response_body = json.loads(response_body)
+        if 'recurringType' in response_body:
+            self.__recurring_type = response_body['recurringType']

global_open_sdk_python-1.7.3/com/alipay/ams/api/request/notify/alipay_card_transaction_event_notify.py

@@ -0,0 +1,287 @@
+import json
+
+from com.alipay.ams.api.model.amount import Amount
+from com.alipay.ams.api.model.event_merchant_info import EventMerchantInfo
+
+
+class AlipayCardTransactionEventNotify:
+    """One flat ABA VCC card transaction event callback (notification profile v2.1, document v2.13).
+
+    Verify the raw-body signature before constructing this object. The merchant handles
+    durable acceptance, eventId deduplication and ACK. Amount values remain quoted
+    minor-unit strings of up to 20 digits. Parsing does not enforce business validation.
+    """
+
+    def __init__(self, notify_body):
+        self.__event_id = None  # type: str
+        self.__lifecycle_id = None  # type: str
+        self.__event_type = None  # type: str
+        self.__auth_time = None  # type: str
+        self.__auth_expire_time = None  # type: str
+        self.__auth_type = None  # type: str
+        self.__auth_code = None  # type: str
+        self.__failure_reason = None  # type: str
+        self.__status = None  # type: str
+        self.__balance_type = None  # type: str
+        self.__transaction_time = None  # type: str
+        self.__bill_type = None  # type: str
+        self.__out_amount = None  # type: Amount
+        self.__in_amount = None  # type: Amount
+        self.__exchange_currency_pair = None  # type: str
+        self.__exchange_rate = None  # type: str
+        self.__transaction_amount = None  # type: Amount
+        self.__asset_id = None  # type: str
+        self.__masked_card_no = None  # type: str
+        self.__card_product = None  # type: str
+        self.__merchant_info = None  # type: EventMerchantInfo
+        self.__metadata = None  # type: dict
+        self.__parse_notify_body(notify_body)
+
+    @property
+    def event_id(self):
+        """Stable event ID and the only callback idempotency key. Required; maximum 64 characters."""
+        return self.__event_id
+
+    @event_id.setter
+    def event_id(self, value):
+        self.__event_id = value
+
+    @property
+    def lifecycle_id(self):
+        """Spend-group ID shared with inquiry. Required; maximum 64 characters."""
+        return self.__lifecycle_id
+
+    @lifecycle_id.setter
+    def lifecycle_id(self, value):
+        self.__lifecycle_id = value
+
+    @property
+    def event_type(self):
+        """Required event type: AUTH, AUTH_CANCEL, CAPTURE, REFUND, CHARGEBACK or REPAYMENT. Preserve unknown future values."""
+        return self.__event_type
+
+    @event_type.setter
+    def event_type(self, value):
+        self.__event_type = value
+
+    @property
+    def auth_time(self):
+        """Optional ISO 8601 time of the channel-correlated authorization, maximum 32 characters. Omitted for AUTH or when unavailable; never inferred from transactionTime or authExpireTime."""
+        return self.__auth_time
+
+    @auth_time.setter
+    def auth_time(self, value):
+        self.__auth_time = value
+
+    @property
+    def auth_expire_time(self):
+        """Optional ISO 8601 authorization expiry time, maximum 32 characters. Sent only for AUTH when available."""
+        return self.__auth_expire_time
+
+    @auth_expire_time.setter
+    def auth_expire_time(self, value):
+        self.__auth_expire_time = value
+
+    @property
+    def auth_type(self):
+        """Optional AUTH or PRE_AUTH, maximum 32 characters. Sent only for AUTH when available."""
+        return self.__auth_type
+
+    @auth_type.setter
+    def auth_type(self, value):
+        self.__auth_type = value
+
+    @property
+    def auth_code(self):
+        """Optional network approval code, maximum 64 characters. Sent only for AUTH when available."""
+        return self.__auth_code
+
+    @auth_code.setter
+    def auth_code(self, value):
+        self.__auth_code = value
+
+    @property
+    def failure_reason(self):
+        """Optional Antom-normalized failure code, maximum 64 characters. Sent only for FAIL when a mapped code exists."""
+        return self.__failure_reason
+
+    @failure_reason.setter
+    def failure_reason(self, value):
+        self.__failure_reason = value
+
+    @property
+    def status(self):
+        """Required terminal status: SUCCESS or FAIL. CAPTURE is SUCCESS-only. The accepted status never changes."""
+        return self.__status
+
+    @status.setter
+    def status(self, value):
+        self.__status = value
+
+    @property
+    def balance_type(self):
+        """ANTOM_BIZ_ACCOUNT or ANTOM_FUND_ACCOUNT, maximum 32 characters. Required with a directional amount; CAPTURE sends ANTOM_BIZ_ACCOUNT."""
+        return self.__balance_type
+
+    @balance_type.setter
+    def balance_type(self, value):
+        self.__balance_type = value
+
+    @property
+    def transaction_time(self):
+        """Required business-event time in ISO 8601 format with timezone; maximum 32 characters."""
+        return self.__transaction_time
+
+    @transaction_time.setter
+    def transaction_time(self, value):
+        self.__transaction_time = value
+
+    @property
+    def bill_type(self):
+        """Required CARD_PAYMENT for AUTH, CAPTURE and REPAYMENT, or CARD_REFUND for AUTH_CANCEL, REFUND and CHARGEBACK."""
+        return self.__bill_type
+
+    @bill_type.setter
+    def bill_type(self, value):
+        self.__bill_type = value
+
+    @property
+    def out_amount(self):
+        """Required for successful AUTH, CAPTURE and REPAYMENT. CAPTURE carries value "0" and billing currency, not another debit; omitted otherwise."""
+        return self.__out_amount
+
+    @out_amount.setter
+    def out_amount(self, value):
+        self.__out_amount = value
+
+    @property
+    def in_amount(self):
+        """Optional billing-currency inflow for successful AUTH_CANCEL, REFUND or CHARGEBACK when available. Omitted for CAPTURE."""
+        return self.__in_amount
+
+    @in_amount.setter
+    def in_amount(self, value):
+        self.__in_amount = value
+
+    @property
+    def exchange_currency_pair(self):
+        """Optional BASE/QUOTE currency pair, maximum 8 characters. Sent with exchangeRate for a cross-currency transaction when both are available."""
+        return self.__exchange_currency_pair
+
+    @exchange_currency_pair.setter
+    def exchange_currency_pair(self, value):
+        self.__exchange_currency_pair = value
+
+    @property
+    def exchange_rate(self):
+        """Optional positive quoted decimal string, maximum 32 characters. One major BASE unit equals this many QUOTE units; paired with exchangeCurrencyPair."""
+        return self.__exchange_rate
+
+    @exchange_rate.setter
+    def exchange_rate(self, value):
+        self.__exchange_rate = value
+
+    @property
+    def transaction_amount(self):
+        """Required current-event amount in original transaction currency. For CAPTURE this is the captured amount, not the zero additional outflow."""
+        return self.__transaction_amount
+
+    @transaction_amount.setter
+    def transaction_amount(self, value):
+        self.__transaction_amount = value
+
+    @property
+    def asset_id(self):
+        """Required merchant-owned card asset ID; maximum 32 characters."""
+        return self.__asset_id
+
+    @asset_id.setter
+    def asset_id(self, value):
+        self.__asset_id = value
+
+    @property
+    def masked_card_no(self):
+        """Optional PCI-safe card mask exposing at most the last four digits; maximum 32 characters."""
+        return self.__masked_card_no
+
+    @masked_card_no.setter
+    def masked_card_no(self, value):
+        self.__masked_card_no = value
+
+    @property
+    def card_product(self):
+        """Optional original-transaction program code matching ^[A-Z0-9]{3}$. Extensible string, not a fixed enum or rebate rate; later card-profile changes do not rewrite it."""
+        return self.__card_product
+
+    @card_product.setter
+    def card_product(self, value):
+        self.__card_product = value
+
+    @property
+    def merchant_info(self):
+        """Optional approved merchant context. Name maximum 256 characters, region exactly 2 and mcc exactly 4; parent omitted when no child is available."""
+        return self.__merchant_info
+
+    @merchant_info.setter
+    def merchant_info(self, value):
+        self.__merchant_info = value
+
+    @property
+    def metadata(self):
+        """Optional approved context: at most 30 entries, keys at most 32 characters, values at most 128 and serialized JSON at most 3096. No key is approved in notification profile v2.1, so it is omitted."""
+        return self.__metadata
+
+    @metadata.setter
+    def metadata(self, value):
+        self.__metadata = value
+
+    def __parse_notify_body(self, notify_body):
+        notify = json.loads(notify_body)
+        if "eventId" in notify:
+            self.__event_id = notify["eventId"]
+        if "lifecycleId" in notify:
+            self.__lifecycle_id = notify["lifecycleId"]
+        if "eventType" in notify:
+            self.__event_type = notify["eventType"]
+        if "authTime" in notify:
+            self.__auth_time = notify["authTime"]
+        if "authExpireTime" in notify:
+            self.__auth_expire_time = notify["authExpireTime"]
+        if "authType" in notify:
+            self.__auth_type = notify["authType"]
+        if "authCode" in notify:
+            self.__auth_code = notify["authCode"]
+        if "failureReason" in notify:
+            self.__failure_reason = notify["failureReason"]
+        if "status" in notify:
+            self.__status = notify["status"]
+        if "balanceType" in notify:
+            self.__balance_type = notify["balanceType"]
+        if "transactionTime" in notify:
+            self.__transaction_time = notify["transactionTime"]
+        if "billType" in notify:
+            self.__bill_type = notify["billType"]
+        if notify.get("outAmount") is not None:
+            self.__out_amount = Amount()
+            self.__out_amount.parse_rsp_body(notify["outAmount"])
+        if notify.get("inAmount") is not None:
+            self.__in_amount = Amount()
+            self.__in_amount.parse_rsp_body(notify["inAmount"])
+        if "exchangeCurrencyPair" in notify:
+            self.__exchange_currency_pair = notify["exchangeCurrencyPair"]
+        if "exchangeRate" in notify:
+            self.__exchange_rate = notify["exchangeRate"]
+        if notify.get("transactionAmount") is not None:
+            self.__transaction_amount = Amount()
+            self.__transaction_amount.parse_rsp_body(notify["transactionAmount"])
+        if "assetId" in notify:
+            self.__asset_id = notify["assetId"]
+        if "maskedCardNo" in notify:
+            self.__masked_card_no = notify["maskedCardNo"]
+        if "cardProduct" in notify:
+            self.__card_product = notify["cardProduct"]
+        if notify.get("merchantInfo") is not None:
+            self.__merchant_info = EventMerchantInfo()
+            self.__merchant_info.parse_rsp_body(notify["merchantInfo"])
+        if "metadata" in notify:
+            self.__metadata = notify["metadata"]