新增isv agenttoken

Author: wangzunjiao

CHANGELOG.md

@@ -1,31 +1,36 @@
 # Changelog
 
-## 1.4.7 - 2024-07-28
+
+## 1.4.7 - 2025-09-24
+  - 新增isv模式 agent-token参数
+  - 补充已知字段
+
+## 1.4.7 - 2025-07-28
   - 修改已知问题
 
-## 1.4.6 - 2024-07-10
+## 1.4.6 - 2025-07-10
   - update 0710
 
-## 1.4.5 - 2024-04-10
+## 1.4.5 - 2025-04-10
   - pay/createPaymentSession支付接口支持订阅支付能力
 
 
-## 1.4.4 - 2024-04-10
+## 1.4.4 - 2025-04-10
 * [#28](https://github.com/alipay/global-open-sdk-python/pull/28)  feature-250410
   - Antom 印度渠道接入AMS拒付相关接口的标准变更 
   - Antom印度渠道接入（UPI/CARD/NETBAKING）相关接口标准变更 
   - CKP二期支持商户传入支付方式地区和支付方式要素
 
 
-## 1.4.3 - 2024-02-05
+## 1.4.3 - 2025-02-05
 * [#27](https://github.com/alipay/global-open-sdk-python/pull/27)  feature-250205
   - 支付、查询、支付结果通知新增卡相关信息字段
 
-## 1.4.2 - 2024-01-22
+## 1.4.2 - 2025-01-22
 * [#26](https://github.com/alipay/global-open-sdk-python/pull/26)  feature-250122
   - update promotionResults
 
-## 1.4.1 - 2024-01-06
+## 1.4.1 - 2025-01-06
 * [#25](https://github.com/alipay/global-open-sdk-python/pull/25)  feature-250105
   - 订阅支付新增“更新接口”
 

com/alipay/ams/api/default_alipay_client.py

@@ -8,12 +8,13 @@
 
 class DefaultAlipayClient(object):
 
-    def __init__(self, gateway_url, client_id, merchant_private_key, alipay_public_key):
+    def __init__(self, gateway_url, client_id, merchant_private_key, alipay_public_key,agent_token = None):
         self.__gateway_url = gateway_url
         self.__client_id = client_id
         self.__merchant_private_key = merchant_private_key
         self.__alipay_public_key = alipay_public_key
         self.__is_sandbox_mode = client_id.startswith("SANDBOX_")
+        self.__agent_token = agent_token
 
     """
     内部方法，生成请求签名
@@ -88,8 +89,11 @@ def execute(self, request):
             "User-Agent": "global-alipay-sdk-python",
             "Request-Time": req_time,
             "client-id": client_id,
-            "Signature": signature
+            "Signature": signature,
         }
+        if self.__agent_token:
+            headers["Agent-Token"] = self.__agent_token
+
 
         url = self.__gateway_url + path
         headers, response = do_post(url, headers, req_body)

com/alipay/ams/api/model/acquirer_info.py

@@ -10,6 +10,7 @@ def __init__(self):
         self.__acquirer_merchant_id = None
         self.__acquirer_result_code = None
         self.__acquirer_result_message = None
+        self.__acquirer_merchant_name = None
 
     @property
     def acquirer_name(self):
@@ -59,6 +60,15 @@ def acquirer_result_message(self):
     def acquirer_result_message(self, acquirer_result_message):
         self.__acquirer_result_message = acquirer_result_message
 
+    @property
+    def acquirer_merchant_name(self):
+        return self.__acquirer_merchant_name
+
+
+    @acquirer_merchant_name.setter
+    def acquirer_merchant_name(self, acquirer_merchant_name):
+        self.__acquirer_merchant_name = acquirer_merchant_name
+
     def parse_rsp_body(self, result_body):
         if type(result_body) == str:
             payment_result_info_body = json.loads(result_body)
@@ -81,6 +91,9 @@ def parse_rsp_body(self, result_body):
         if 'acquirerResultMessage' in result_body:
             self.__acquirer_result_message = result_body['acquirerResultMessage']
 
+        if 'acquirerMerchantName' in result_body:
+            self.__acquirer_merchant_name = result_body['acquirerMerchantName']
+
 
 
 

com/alipay/ams/api/model/credential_type.py

@@ -0,0 +1,10 @@
+from enum import Enum, unique
+
+
+@unique
+class CredentialType(Enum):
+    NETWORK_TOKEN = "NETWORK_TOKEN"
+    PAN = "PAN"
+
+    def to_ams_dict(self):
+        return self.name

com/alipay/ams/api/model/mpi_data.py

@@ -0,0 +1,85 @@
+import json
+
+
+class MpiData(object):
+
+    def __init__(self):
+        self.__three_ds_version = None
+        self.eci = None
+        self.cavv = None
+        self.ds_transaction_id = None
+        self.credential_type = None
+
+    @property
+    def three_ds_version(self):
+        return self.__three_ds_version
+
+    @three_ds_version.setter
+    def three_ds_version(self, value):
+        self.__three_ds_version = value
+
+
+    @property
+    def eci(self):
+        return self.__eci
+
+    @eci.setter
+    def eci(self, value):
+        self.__eci = value
+
+
+    @property
+    def cavv(self):
+        return self.__cavv
+
+    @cavv.setter
+    def cavv(self, value):
+        self.__cavv = value
+
+
+    @property
+    def ds_transaction_id(self):
+        return self.__ds_transaction_id
+
+    @ds_transaction_id.setter
+    def ds_transaction_id(self, value):
+        self.__ds_transaction_id = value
+
+    @property
+    def credential_type(self):
+        return self.__credential_type
+
+    @credential_type.setter
+    def credential_type(self, value):
+        self.__credential_type = value
+
+
+    def to_ams_dict(self):
+        ams_dict = {}
+        if self.three_ds_version:
+            ams_dict['threeDSVersion'] = self.three_ds_version
+        if self.eci:
+            ams_dict['eci'] = self.eci
+        if self.cavv:
+            ams_dict['cavv'] = self.cavv
+        if self.ds_transaction_id:
+            ams_dict['dsTransactionId'] = self.ds_transaction_id
+        if self.credential_type:
+            ams_dict['credentialType'] = self.credential_type
+        return ams_dict
+
+
+    def parse_rsp_body(self, response_body):
+        if type(response_body) == str:
+            response_body = json.loads(response_body)
+            if 'threeDSVersion' in response_body:
+                self.three_ds_version = response_body['threeDSVersion']
+            if 'eci' in response_body:
+                self.eci = response_body['eci']
+            if 'cavv' in response_body:
+                self.cavv = response_body['cavv']
+            if 'dsTransactionId' in response_body:
+                self.ds_transaction_id = response_body['dsTransactionId']
+            if 'credentialType' in response_body:
+                self.credential_type = response_body['credentialType']
+

com/alipay/ams/api/model/payment_method.py

@@ -2,6 +2,8 @@
 # -*- coding: utf-8 -*-
 import json
 
+from com.alipay.ams.api.model.funding_type import FundingType
+
 
 class PaymentMethod(object):
     def __init__(self):
@@ -10,6 +12,8 @@ def __init__(self):
         self.__payment_method_meta_data = None #type: map
         self.__customer_id = None
         self.__extend_info = None
+        self.__require_issuer_authentication = None #type: bool
+        self.funding = None #type: FundingType
 
     @property
     def payment_method_type(self):
@@ -51,6 +55,21 @@ def extend_info(self):
     def extend_info(self, value):
         self.__extend_info = value
 
+    @property
+    def require_issuer_authentication(self):
+        return self.__require_issuer_authentication
+    @require_issuer_authentication.setter
+    def require_issuer_authentication(self, value):
+        self.__require_issuer_authentication = value
+
+    @property
+    def funding(self):
+        return self.__funding
+
+    @funding.setter
+    def funding(self, value):
+        self.__funding = value
+
     def to_ams_dict(self):
         params = dict()
         if hasattr(self, "payment_method_type") and self.payment_method_type:
@@ -68,6 +87,12 @@ def to_ams_dict(self):
         if hasattr(self, "extend_info") and self.extend_info:
             params['extendInfo'] = self.extend_info
 
+        if hasattr(self, "require_issuer_authentication") and self.require_issuer_authentication:
+            params['requireIssuerAuthentication'] = self.require_issuer_authentication
+
+        if hasattr(self, "funding") and self.funding:
+            params['funding'] = self.funding
+
         return params
 
     def parse_rsp_body(self, response_body):
@@ -83,4 +108,8 @@ def parse_rsp_body(self, response_body):
         if 'paymentMethodId' in response_body:
             self.payment_method_id = response_body['paymentMethodId']
         if 'extendInfo' in response_body:
-            self.extend_info = response_body['extendInfo']
+            self.extend_info = response_body['extendInfo']
+        if 'requireIssuerAuthentication' in response_body:
+            self.require_issuer_authentication = response_body['requireIssuerAuthentication']
+        if 'funding' in response_body:
+            self.funding = response_body['funding']

com/alipay/ams/api/model/payment_result_info.py

@@ -1,5 +1,8 @@
 import json
 
+from com.alipay.ams.api.model.acquirer_info import AcquirerInfo
+from com.alipay.ams.api.model.three_ds_result import ThreeDSResult
+
 
 class PaymentResultInfo(object):
 
@@ -20,6 +23,11 @@ def __init__(self):
         self.__last_four = None
         self.__expiry_month = None
         self.__expiry_year = None
+        self.__account_no = None
+        self.__refusal_code_raw = None
+        self.__refusal_reason_raw = None
+        self.__merchant_advice_code = None
+        self.__acquirer_info = None #type: AcquirerInfo
 
 
     @property
@@ -150,6 +158,50 @@ def expiry_year(self):
     def expiry_year(self, value):
         self.__expiry_year = value
 
+
+    @property
+    def account_no(self):
+        return self.__account_no
+
+    @account_no.setter
+    def account_no(self, value):
+        self.__account_no = value
+
+    @property
+    def refusal_code_raw(self):
+        return self.__refusal_code_raw
+
+    @refusal_code_raw.setter
+    def refusal_code_raw(self, value):
+        self.__refusal_code_raw = value
+
+
+    @property
+    def refusal_reason_raw(self):
+        return self.__refusal_reason_raw
+
+    @refusal_reason_raw.setter
+    def refusal_reason_raw(self, value):
+        self.__refusal_reason_raw = value
+
+    @property
+    def merchant_advice_code(self):
+        return self.__merchant_advice_code
+
+    @merchant_advice_code.setter
+    def merchant_advice_code(self, value):
+        self.__merchant_advice_code = value
+
+    @property
+    def acquirer_info(self):
+        return self.__acquirer_info
+
+    @acquirer_info.setter
+    def acquirer_info(self, value):
+        self.__acquirer_info = value
+
+
+
     def to_ams_dict(self):
         param = dict()
         if hasattr(self, 'avs_result_raw') and self.avs_result_raw:
@@ -184,6 +236,16 @@ def to_ams_dict(self):
             param['expiryMonth'] = self.expiry_month
         if hasattr(self, 'expiry_year') and self.expiry_year:
             param['expiryYear'] = self.expiry_year
+        if hasattr(self, 'account_no') and self.account_no:
+            param['accountNo'] = self.account_no
+        if hasattr(self, 'refusal_code_raw') and self.refusal_code_raw:
+            param['refusalCodeRaw'] = self.refusal_code_raw
+        if hasattr(self, 'refusal_reason_raw') and self.refusal_reason_raw:
+            param['refusalReasonRaw'] = self.refusal_reason_raw
+        if hasattr(self, 'merchant_advice_code') and self.merchant_advice_code:
+            param['merchantAdviceCode'] = self.merchant_advice_code
+        if hasattr(self, 'acquirer_info') and self.acquirer_info:
+            param['acquirerInfo'] = self.acquirer_info
 
         return param
 
@@ -223,3 +285,13 @@ def parse_rsp_body(self, payment_result_info_body):
             self.expiry_month = payment_result_info_body['expiryMonth']
         if 'expiryYear' in payment_result_info_body:
             self.expiry_year = payment_result_info_body['expiryYear']
+        if 'accountNo' in payment_result_info_body:
+            self.account_no = payment_result_info_body['accountNo']
+        if 'refusalCodeRaw' in payment_result_info_body:
+            self.refusal_code_raw = payment_result_info_body['refusalCodeRaw']
+        if 'refusalReasonRaw' in payment_result_info_body:
+            self.refusal_reason_raw = payment_result_info_body['refusalReasonRaw']
+        if 'merchantAdviceCode' in payment_result_info_body:
+            self.merchant_advice_code = payment_result_info_body['merchantAdviceCode']
+        if 'acquirerInfo' in payment_result_info_body:
+            self.acquirer_info = payment_result_info_body['acquirerInfo']