onlinepayments-sdk-python3 4.22.0__zip → 5.0.0__zip

onlinepayments_sdk_python3-5.0.0/onlinepayments/sdk/domain/three_d_secure.py

@@ -0,0 +1,281 @@
+# -*- coding: utf-8 -*-
+#
+# This file was automatically generated.
+#
+from typing import Optional
+
+from .data_object import DataObject
+from .external_cardholder_authentication_data import ExternalCardholderAuthenticationData
+from .redirection_data import RedirectionData
+from .three_d_secure_data import ThreeDSecureData
+
+
+class ThreeDSecure(DataObject):
+
+    __authentication_amount: Optional[int] = None
+    __challenge_canvas_size: Optional[str] = None
+    __challenge_indicator: Optional[str] = None
+    __device_channel: Optional[str] = None
+    __exemption_request: Optional[str] = None
+    __external_cardholder_authentication_data: Optional[ExternalCardholderAuthenticationData] = None
+    __merchant_fraud_rate: Optional[int] = None
+    __prior_three_d_secure_data: Optional[ThreeDSecureData] = None
+    __redirection_data: Optional[RedirectionData] = None
+    __secure_corporate_payment: Optional[bool] = None
+    __skip_authentication: Optional[bool] = None
+    __skip_soft_decline: Optional[bool] = None
+
+    @property
+    def authentication_amount(self) -> Optional[int]:
+        """
+        | The amount to be authenticated. This field should be populated if the amount to be authenticated differs from the amount to be authorized (by default they are considered equal). Amount in cents and always having 2 decimals.
+
+        Type: int
+        """
+        return self.__authentication_amount
+
+    @authentication_amount.setter
+    def authentication_amount(self, value: Optional[int]) -> None:
+        self.__authentication_amount = value
+
+    @property
+    def challenge_canvas_size(self) -> Optional[str]:
+        """
+        | Dimensions of the challenge window that potentially will be displayed to the customer. The challenge content is formatted to appropriately render in this window to provide the best possible user experience. Preconfigured sizes are width x height in pixels of the window displayed in the customer browser window. Possible values are
+        
+        * 250x400 (default)
+        * 390x400
+        * 500x600
+        * 600x400
+        * full-screen
+
+        Type: str
+        """
+        return self.__challenge_canvas_size
+
+    @challenge_canvas_size.setter
+    def challenge_canvas_size(self, value: Optional[str]) -> None:
+        self.__challenge_canvas_size = value
+
+    @property
+    def challenge_indicator(self) -> Optional[str]:
+        """
+        | Allows you to indicate if you want the customer to be challenged for extra security on this transaction. Possible values:
+        
+        * no-preference - You have no preference whether or not to challenge the customer (default)
+        * no-challenge-requested - you prefer the cardholder not to be challenged
+        * challenge-requested - you prefer the customer to be challenged
+        * challenge-required - you require the customer to be challenged
+        * no-challenge-requested-risk-analysis-performed – letting the issuer know that you have already assessed the transaction with fraud prevention tool
+        * no-challenge-requested-data-share-only – sharing data only with the DS
+        * no-challenge-requested-consumer-authentication-performed – authentication already happened at your side – when login in to your website
+        * no-challenge-requested-use-whitelist-exemption – cardholder has whitelisted you at with the issuer
+        * challenge-requested-whitelist-prompt-requested – cardholder is trying to whitelist you
+        * request-scoring-without-connecting-to-acs – sending information to CB DS for a fraud scoring
+
+        Type: str
+        """
+        return self.__challenge_indicator
+
+    @challenge_indicator.setter
+    def challenge_indicator(self, value: Optional[str]) -> None:
+        self.__challenge_indicator = value
+
+    @property
+    def device_channel(self) -> Optional[str]:
+        """
+        | Determines whether the call is coming from an application or from a browser * AppBased - Call is coming from an application.  * Browser - Call is coming from a browser
+
+        Type: str
+        """
+        return self.__device_channel
+
+    @device_channel.setter
+    def device_channel(self, value: Optional[str]) -> None:
+        self.__device_channel = value
+
+    @property
+    def exemption_request(self) -> Optional[str]:
+        """
+        | In PSD2, the ExemptionRequest field is used by merchants requesting an exemption when not using authentication on a transaction, in order to keep the conversion up.
+        
+        * none = No exemption requested
+        * transaction-risk-analysis = Fraud analysis has been done already by your own fraud module and transaction scored as low risk
+        * low-value = Bellow 30 euros
+        * whitelist = The cardholder has whitelisted you with their issuer
+
+        Type: str
+        """
+        return self.__exemption_request
+
+    @exemption_request.setter
+    def exemption_request(self, value: Optional[str]) -> None:
+        self.__exemption_request = value
+
+    @property
+    def external_cardholder_authentication_data(self) -> Optional[ExternalCardholderAuthenticationData]:
+        """
+        | Object containing 3D secure details.
+
+        Type: :class:`onlinepayments.sdk.domain.external_cardholder_authentication_data.ExternalCardholderAuthenticationData`
+        """
+        return self.__external_cardholder_authentication_data
+
+    @external_cardholder_authentication_data.setter
+    def external_cardholder_authentication_data(self, value: Optional[ExternalCardholderAuthenticationData]) -> None:
+        self.__external_cardholder_authentication_data = value
+
+    @property
+    def merchant_fraud_rate(self) -> Optional[int]:
+        """
+        | Merchant fraud rate in the EEA (all EEA card fraud divided by all EEA card volumes) calculated as per PSD2 RTS. Mastercard will not calculate or validate the merchant fraud score Values accepted :
+        
+        * 1 - represents fraud rate less than or equal to 1 basis point [bp], which is 0.01%
+        * 2 - represents fraud rate between 1 bp + - and 6 bps
+        * 3 - represents fraud rate between 6 bps + - and 13 bps
+        * 4 - represents fraud rate between 13 bps + - and 25 bps
+        * 5 - represents fraud rate greater than 25 bps
+
+        Type: int
+        """
+        return self.__merchant_fraud_rate
+
+    @merchant_fraud_rate.setter
+    def merchant_fraud_rate(self, value: Optional[int]) -> None:
+        self.__merchant_fraud_rate = value
+
+    @property
+    def prior_three_d_secure_data(self) -> Optional[ThreeDSecureData]:
+        """
+        | Object containing data regarding the customer authentication that occurred prior to the current transaction
+
+        Type: :class:`onlinepayments.sdk.domain.three_d_secure_data.ThreeDSecureData`
+        """
+        return self.__prior_three_d_secure_data
+
+    @prior_three_d_secure_data.setter
+    def prior_three_d_secure_data(self, value: Optional[ThreeDSecureData]) -> None:
+        self.__prior_three_d_secure_data = value
+
+    @property
+    def redirection_data(self) -> Optional[RedirectionData]:
+        """
+        | Object containing browser specific redirection related data
+
+        Type: :class:`onlinepayments.sdk.domain.redirection_data.RedirectionData`
+        """
+        return self.__redirection_data
+
+    @redirection_data.setter
+    def redirection_data(self, value: Optional[RedirectionData]) -> None:
+        self.__redirection_data = value
+
+    @property
+    def secure_corporate_payment(self) -> Optional[bool]:
+        """
+        | Indicates dedicated payment processes and procedures were used, potential secure corporate payment exemption applies Logically this field should only be set to yes if the acquirer exemption field is blank. A merchant cannot claim both acquirer exemption and  secure payment. However, the DS will not validate the conditions in the extension. DS will pass data as presented.
+
+        Type: bool
+        """
+        return self.__secure_corporate_payment
+
+    @secure_corporate_payment.setter
+    def secure_corporate_payment(self, value: Optional[bool]) -> None:
+        self.__secure_corporate_payment = value
+
+    @property
+    def skip_authentication(self) -> Optional[bool]:
+        """
+        * true = 3D Secure authentication will be skipped for this transaction. This setting should be used when isRecurring is set to true and recurringPaymentSequenceIndicator is set to "recurring"
+        * false = 3D Secure authentication will not be skipped for this transaction
+        
+        | Note: This is only possible if your account in our system is setup for 3D Secure authentication and if your configuration in our system allows you to override it per transaction
+
+        Type: bool
+        """
+        return self.__skip_authentication
+
+    @skip_authentication.setter
+    def skip_authentication(self, value: Optional[bool]) -> None:
+        self.__skip_authentication = value
+
+    @property
+    def skip_soft_decline(self) -> Optional[bool]:
+        """
+        * true = Soft Decline retry mechanism will be skipped for this transaction. The transaction will result in "Authorization Declined" status. This setting should be used when skipAuthentication is set to true and the merchant does not want to use Soft Decline retry mechanism.
+        * false = Soft Decline retry mechanism will not be skipped for this transaction.
+        
+        | Note: skipSoftDecline defaults to false if empty. This is only possible if your account in our system is setup for 3D Secure authentication and if your configuration in our system allows you to override it per transaction.
+
+        Type: bool
+        """
+        return self.__skip_soft_decline
+
+    @skip_soft_decline.setter
+    def skip_soft_decline(self, value: Optional[bool]) -> None:
+        self.__skip_soft_decline = value
+
+    def to_dictionary(self) -> dict:
+        dictionary = super(ThreeDSecure, self).to_dictionary()
+        if self.authentication_amount is not None:
+            dictionary['authenticationAmount'] = self.authentication_amount
+        if self.challenge_canvas_size is not None:
+            dictionary['challengeCanvasSize'] = self.challenge_canvas_size
+        if self.challenge_indicator is not None:
+            dictionary['challengeIndicator'] = self.challenge_indicator
+        if self.device_channel is not None:
+            dictionary['deviceChannel'] = self.device_channel
+        if self.exemption_request is not None:
+            dictionary['exemptionRequest'] = self.exemption_request
+        if self.external_cardholder_authentication_data is not None:
+            dictionary['externalCardholderAuthenticationData'] = self.external_cardholder_authentication_data.to_dictionary()
+        if self.merchant_fraud_rate is not None:
+            dictionary['merchantFraudRate'] = self.merchant_fraud_rate
+        if self.prior_three_d_secure_data is not None:
+            dictionary['priorThreeDSecureData'] = self.prior_three_d_secure_data.to_dictionary()
+        if self.redirection_data is not None:
+            dictionary['redirectionData'] = self.redirection_data.to_dictionary()
+        if self.secure_corporate_payment is not None:
+            dictionary['secureCorporatePayment'] = self.secure_corporate_payment
+        if self.skip_authentication is not None:
+            dictionary['skipAuthentication'] = self.skip_authentication
+        if self.skip_soft_decline is not None:
+            dictionary['skipSoftDecline'] = self.skip_soft_decline
+        return dictionary
+
+    def from_dictionary(self, dictionary: dict) -> 'ThreeDSecure':
+        super(ThreeDSecure, self).from_dictionary(dictionary)
+        if 'authenticationAmount' in dictionary:
+            self.authentication_amount = dictionary['authenticationAmount']
+        if 'challengeCanvasSize' in dictionary:
+            self.challenge_canvas_size = dictionary['challengeCanvasSize']
+        if 'challengeIndicator' in dictionary:
+            self.challenge_indicator = dictionary['challengeIndicator']
+        if 'deviceChannel' in dictionary:
+            self.device_channel = dictionary['deviceChannel']
+        if 'exemptionRequest' in dictionary:
+            self.exemption_request = dictionary['exemptionRequest']
+        if 'externalCardholderAuthenticationData' in dictionary:
+            if not isinstance(dictionary['externalCardholderAuthenticationData'], dict):
+                raise TypeError('value \'{}\' is not a dictionary'.format(dictionary['externalCardholderAuthenticationData']))
+            value = ExternalCardholderAuthenticationData()
+            self.external_cardholder_authentication_data = value.from_dictionary(dictionary['externalCardholderAuthenticationData'])
+        if 'merchantFraudRate' in dictionary:
+            self.merchant_fraud_rate = dictionary['merchantFraudRate']
+        if 'priorThreeDSecureData' in dictionary:
+            if not isinstance(dictionary['priorThreeDSecureData'], dict):
+                raise TypeError('value \'{}\' is not a dictionary'.format(dictionary['priorThreeDSecureData']))
+            value = ThreeDSecureData()
+            self.prior_three_d_secure_data = value.from_dictionary(dictionary['priorThreeDSecureData'])
+        if 'redirectionData' in dictionary:
+            if not isinstance(dictionary['redirectionData'], dict):
+                raise TypeError('value \'{}\' is not a dictionary'.format(dictionary['redirectionData']))
+            value = RedirectionData()
+            self.redirection_data = value.from_dictionary(dictionary['redirectionData'])
+        if 'secureCorporatePayment' in dictionary:
+            self.secure_corporate_payment = dictionary['secureCorporatePayment']
+        if 'skipAuthentication' in dictionary:
+            self.skip_authentication = dictionary['skipAuthentication']
+        if 'skipSoftDecline' in dictionary:
+            self.skip_soft_decline = dictionary['skipSoftDecline']
+        return self

onlinepayments_sdk_python3-5.0.0/onlinepayments/sdk/domain/three_d_secure_base.py

@@ -0,0 +1,219 @@
+# -*- coding: utf-8 -*-
+#
+# This file was automatically generated.
+#
+from typing import Optional
+
+from .data_object import DataObject
+from .three_d_secure_data import ThreeDSecureData
+
+
+class ThreeDSecureBase(DataObject):
+
+    __authentication_amount: Optional[int] = None
+    __challenge_canvas_size: Optional[str] = None
+    __challenge_indicator: Optional[str] = None
+    __exemption_request: Optional[str] = None
+    __merchant_fraud_rate: Optional[int] = None
+    __prior_three_d_secure_data: Optional[ThreeDSecureData] = None
+    __secure_corporate_payment: Optional[bool] = None
+    __skip_authentication: Optional[bool] = None
+    __skip_soft_decline: Optional[bool] = None
+
+    @property
+    def authentication_amount(self) -> Optional[int]:
+        """
+        | The amount to be authenticated. This field should be populated if the amount to be authenticated differs from the amount to be authorized (by default they are considered equal). Amount in cents and always having 2 decimals.
+
+        Type: int
+        """
+        return self.__authentication_amount
+
+    @authentication_amount.setter
+    def authentication_amount(self, value: Optional[int]) -> None:
+        self.__authentication_amount = value
+
+    @property
+    def challenge_canvas_size(self) -> Optional[str]:
+        """
+        | Dimensions of the challenge window that potentially will be displayed to the customer. The challenge content is formatted to appropriately render in this window to provide the best possible user experience. Preconfigured sizes are width x height in pixels of the window displayed in the customer browser window. Possible values are
+        
+        * 250x400 (default)
+        * 390x400
+        * 500x600
+        * 600x400
+        * full-screen
+
+        Type: str
+        """
+        return self.__challenge_canvas_size
+
+    @challenge_canvas_size.setter
+    def challenge_canvas_size(self, value: Optional[str]) -> None:
+        self.__challenge_canvas_size = value
+
+    @property
+    def challenge_indicator(self) -> Optional[str]:
+        """
+        | Allows you to indicate if you want the customer to be challenged for extra security on this transaction. Possible values:
+        
+        * no-preference - You have no preference whether or not to challenge the customer (default)
+        * no-challenge-requested - you prefer the cardholder not to be challenged
+        * challenge-requested - you prefer the customer to be challenged
+        * challenge-required - you require the customer to be challenged
+        * no-challenge-requested-risk-analysis-performed – letting the issuer know that you have already assessed the transaction with fraud prevention tool
+        * no-challenge-requested-data-share-only – sharing data only with the DS
+        * no-challenge-requested-consumer-authentication-performed – authentication already happened at your side – when login in to your website
+        * no-challenge-requested-use-whitelist-exemption – cardholder has whitelisted you at with the issuer
+        * challenge-requested-whitelist-prompt-requested – cardholder is trying to whitelist you
+        * request-scoring-without-connecting-to-acs – sending information to CB DS for a fraud scoring
+
+        Type: str
+        """
+        return self.__challenge_indicator
+
+    @challenge_indicator.setter
+    def challenge_indicator(self, value: Optional[str]) -> None:
+        self.__challenge_indicator = value
+
+    @property
+    def exemption_request(self) -> Optional[str]:
+        """
+        | In PSD2, the ExemptionRequest field is used by merchants requesting an exemption when not using authentication on a transaction, in order to keep the conversion up.
+        
+        * none = No exemption requested
+        * transaction-risk-analysis = Fraud analysis has been done already by your own fraud module and transaction scored as low risk
+        * low-value = Bellow 30 euros
+        * whitelist = The cardholder has whitelisted you with their issuer
+
+        Type: str
+        """
+        return self.__exemption_request
+
+    @exemption_request.setter
+    def exemption_request(self, value: Optional[str]) -> None:
+        self.__exemption_request = value
+
+    @property
+    def merchant_fraud_rate(self) -> Optional[int]:
+        """
+        | Merchant fraud rate in the EEA (all EEA card fraud divided by all EEA card volumes) calculated as per PSD2 RTS. Mastercard will not calculate or validate the merchant fraud score Values accepted :
+        
+        * 1 - represents fraud rate less than or equal to 1 basis point [bp], which is 0.01%
+        * 2 - represents fraud rate between 1 bp + - and 6 bps
+        * 3 - represents fraud rate between 6 bps + - and 13 bps
+        * 4 - represents fraud rate between 13 bps + - and 25 bps
+        * 5 - represents fraud rate greater than 25 bps
+
+        Type: int
+        """
+        return self.__merchant_fraud_rate
+
+    @merchant_fraud_rate.setter
+    def merchant_fraud_rate(self, value: Optional[int]) -> None:
+        self.__merchant_fraud_rate = value
+
+    @property
+    def prior_three_d_secure_data(self) -> Optional[ThreeDSecureData]:
+        """
+        | Object containing data regarding the customer authentication that occurred prior to the current transaction
+
+        Type: :class:`onlinepayments.sdk.domain.three_d_secure_data.ThreeDSecureData`
+        """
+        return self.__prior_three_d_secure_data
+
+    @prior_three_d_secure_data.setter
+    def prior_three_d_secure_data(self, value: Optional[ThreeDSecureData]) -> None:
+        self.__prior_three_d_secure_data = value
+
+    @property
+    def secure_corporate_payment(self) -> Optional[bool]:
+        """
+        | Indicates dedicated payment processes and procedures were used, potential secure corporate payment exemption applies Logically this field should only be set to yes if the acquirer exemption field is blank. A merchant cannot claim both acquirer exemption and  secure payment. However, the DS will not validate the conditions in the extension. DS will pass data as presented.
+
+        Type: bool
+        """
+        return self.__secure_corporate_payment
+
+    @secure_corporate_payment.setter
+    def secure_corporate_payment(self, value: Optional[bool]) -> None:
+        self.__secure_corporate_payment = value
+
+    @property
+    def skip_authentication(self) -> Optional[bool]:
+        """
+        * true = 3D Secure authentication will be skipped for this transaction. This setting should be used when isRecurring is set to true and recurringPaymentSequenceIndicator is set to "recurring"
+        * false = 3D Secure authentication will not be skipped for this transaction
+        
+        | Note: This is only possible if your account in our system is setup for 3D Secure authentication and if your configuration in our system allows you to override it per transaction
+
+        Type: bool
+        """
+        return self.__skip_authentication
+
+    @skip_authentication.setter
+    def skip_authentication(self, value: Optional[bool]) -> None:
+        self.__skip_authentication = value
+
+    @property
+    def skip_soft_decline(self) -> Optional[bool]:
+        """
+        * true = Soft Decline retry mechanism will be skipped for this transaction. The transaction will result in "Authorization Declined" status. This setting should be used when skipAuthentication is set to true and the merchant does not want to use Soft Decline retry mechanism.
+        * false = Soft Decline retry mechanism will not be skipped for this transaction.
+        
+        | Note: skipSoftDecline defaults to false if empty. This is only possible if your account in our system is setup for 3D Secure authentication and if your configuration in our system allows you to override it per transaction.
+
+        Type: bool
+        """
+        return self.__skip_soft_decline
+
+    @skip_soft_decline.setter
+    def skip_soft_decline(self, value: Optional[bool]) -> None:
+        self.__skip_soft_decline = value
+
+    def to_dictionary(self) -> dict:
+        dictionary = super(ThreeDSecureBase, self).to_dictionary()
+        if self.authentication_amount is not None:
+            dictionary['authenticationAmount'] = self.authentication_amount
+        if self.challenge_canvas_size is not None:
+            dictionary['challengeCanvasSize'] = self.challenge_canvas_size
+        if self.challenge_indicator is not None:
+            dictionary['challengeIndicator'] = self.challenge_indicator
+        if self.exemption_request is not None:
+            dictionary['exemptionRequest'] = self.exemption_request
+        if self.merchant_fraud_rate is not None:
+            dictionary['merchantFraudRate'] = self.merchant_fraud_rate
+        if self.prior_three_d_secure_data is not None:
+            dictionary['priorThreeDSecureData'] = self.prior_three_d_secure_data.to_dictionary()
+        if self.secure_corporate_payment is not None:
+            dictionary['secureCorporatePayment'] = self.secure_corporate_payment
+        if self.skip_authentication is not None:
+            dictionary['skipAuthentication'] = self.skip_authentication
+        if self.skip_soft_decline is not None:
+            dictionary['skipSoftDecline'] = self.skip_soft_decline
+        return dictionary
+
+    def from_dictionary(self, dictionary: dict) -> 'ThreeDSecureBase':
+        super(ThreeDSecureBase, self).from_dictionary(dictionary)
+        if 'authenticationAmount' in dictionary:
+            self.authentication_amount = dictionary['authenticationAmount']
+        if 'challengeCanvasSize' in dictionary:
+            self.challenge_canvas_size = dictionary['challengeCanvasSize']
+        if 'challengeIndicator' in dictionary:
+            self.challenge_indicator = dictionary['challengeIndicator']
+        if 'exemptionRequest' in dictionary:
+            self.exemption_request = dictionary['exemptionRequest']
+        if 'merchantFraudRate' in dictionary:
+            self.merchant_fraud_rate = dictionary['merchantFraudRate']
+        if 'priorThreeDSecureData' in dictionary:
+            if not isinstance(dictionary['priorThreeDSecureData'], dict):
+                raise TypeError('value \'{}\' is not a dictionary'.format(dictionary['priorThreeDSecureData']))
+            value = ThreeDSecureData()
+            self.prior_three_d_secure_data = value.from_dictionary(dictionary['priorThreeDSecureData'])
+        if 'secureCorporatePayment' in dictionary:
+            self.secure_corporate_payment = dictionary['secureCorporatePayment']
+        if 'skipAuthentication' in dictionary:
+            self.skip_authentication = dictionary['skipAuthentication']
+        if 'skipSoftDecline' in dictionary:
+            self.skip_soft_decline = dictionary['skipSoftDecline']
+        return self

{onlinepayments-sdk-python3-4.22.0 → onlinepayments_sdk_python3-5.0.0}/onlinepayments/sdk/domain/three_d_secure_data.py

@@ -1,21 +1,20 @@
 # -*- coding: utf-8 -*-
 #
-# This class was auto-generated.
+# This file was automatically generated.
 #
-from onlinepayments.sdk.data_object import DataObject
+from typing import Optional
+
+from .data_object import DataObject
 
 
 class ThreeDSecureData(DataObject):
-    """
-    | Object containing data regarding the customer authentication that occurred prior to the current transaction
-    """
 
-    __acs_transaction_id = None
-    __method = None
-    __utc_timestamp = None
+    __acs_transaction_id: Optional[str] = None
+    __method: Optional[str] = None
+    __utc_timestamp: Optional[str] = None
 
     @property
-    def acs_transaction_id(self) -> str:
+    def acs_transaction_id(self) -> Optional[str]:
         """
         | The ACS Transaction ID for a prior 3-D Secure authenticated transaction (for example, the first recurring transaction that was authenticated with the customer)
 
@@ -24,28 +23,29 @@ class ThreeDSecureData(DataObject):
         return self.__acs_transaction_id
 
     @acs_transaction_id.setter
-    def acs_transaction_id(self, value: str):
+    def acs_transaction_id(self, value: Optional[str]) -> None:
         self.__acs_transaction_id = value
 
     @property
-    def method(self) -> str:
+    def method(self) -> Optional[str]:
         """
         | Method of authentication used for this transaction. Possible values:
-        |  * frictionless = The authentication went without a challenge
-        |  * challenged = Cardholder was challenged
-        |  * avs-verified = The authentication was verified by AVS
-        |  * other = Another issuer method was used to authenticate this transaction
+        
+        * frictionless = The authentication went without a challenge
+        * challenged = Cardholder was challenged
+        * avs-verified = The authentication was verified by AVS
+        * other = Another issuer method was used to authenticate this transaction
 
         Type: str
         """
         return self.__method
 
     @method.setter
-    def method(self, value: str):
+    def method(self, value: Optional[str]) -> None:
         self.__method = value
 
     @property
-    def utc_timestamp(self) -> str:
+    def utc_timestamp(self) -> Optional[str]:
         """
         | Timestamp in UTC (YYYYMMDDHHmm) of the 3-D Secure authentication of this transaction
 
@@ -54,10 +54,10 @@ class ThreeDSecureData(DataObject):
         return self.__utc_timestamp
 
     @utc_timestamp.setter
-    def utc_timestamp(self, value: str):
+    def utc_timestamp(self, value: Optional[str]) -> None:
         self.__utc_timestamp = value
 
-    def to_dictionary(self):
+    def to_dictionary(self) -> dict:
         dictionary = super(ThreeDSecureData, self).to_dictionary()
         if self.acs_transaction_id is not None:
             dictionary['acsTransactionId'] = self.acs_transaction_id
@@ -67,7 +67,7 @@ class ThreeDSecureData(DataObject):
             dictionary['utcTimestamp'] = self.utc_timestamp
         return dictionary
 
-    def from_dictionary(self, dictionary):
+    def from_dictionary(self, dictionary: dict) -> 'ThreeDSecureData':
         super(ThreeDSecureData, self).from_dictionary(dictionary)
         if 'acsTransactionId' in dictionary:
             self.acs_transaction_id = dictionary['acsTransactionId']