Package com.adyen.model.checkout

Class AdditionalDataCommon

  • public class AdditionalDataCommon
extends Object
    AdditionalDataCommon

    • Constructor Detail

      • AdditionalDataCommon

        public AdditionalDataCommon()

    • Method Detail

      • requestedTestErrorResponseCode

        public AdditionalDataCommon requestedTestErrorResponseCode​(String requestedTestErrorResponseCode)

      • getRequestedTestErrorResponseCode

        public String getRequestedTestErrorResponseCode()
        Triggers test scenarios that allow to replicate certain communication errors. Allowed values: * **NO_CONNECTION_AVAILABLE** – There wasn't a connection available to service the outgoing communication. This is a transient, retriable error since no messaging could be initiated to an issuing system (or third-party acquiring system). Therefore, the header Transient-Error: true is returned in the response. A subsequent request using the same idempotency key will be processed as if it was the first request. * **IOEXCEPTION_RECEIVED** – Something went wrong during transmission of the message or receiving the response. This is a classified as non-transient because the message could have been received by the issuing party and been acted upon. No transient error header is returned. If using idempotency, the (error) response is stored as the final result for the idempotency key. Subsequent messages with the same idempotency key not be processed beyond returning the stored response.
        Returns:
        requestedTestErrorResponseCode

      • setRequestedTestErrorResponseCode

        public void setRequestedTestErrorResponseCode​(String requestedTestErrorResponseCode)
        Triggers test scenarios that allow to replicate certain communication errors. Allowed values: * **NO_CONNECTION_AVAILABLE** – There wasn't a connection available to service the outgoing communication. This is a transient, retriable error since no messaging could be initiated to an issuing system (or third-party acquiring system). Therefore, the header Transient-Error: true is returned in the response. A subsequent request using the same idempotency key will be processed as if it was the first request. * **IOEXCEPTION_RECEIVED** – Something went wrong during transmission of the message or receiving the response. This is a classified as non-transient because the message could have been received by the issuing party and been acted upon. No transient error header is returned. If using idempotency, the (error) response is stored as the final result for the idempotency key. Subsequent messages with the same idempotency key not be processed beyond returning the stored response.
        Parameters:
        requestedTestErrorResponseCode -

      • getAllowPartialAuth

        public String getAllowPartialAuth()
        Set to true to authorise a part of the requested amount in case the cardholder does not have enough funds on their account. If a payment was partially authorised, the response includes resultCode: PartiallyAuthorised and the authorised amount in additionalData.authorisedAmountValue. To enable this functionality, contact our Support Team.
        Returns:
        allowPartialAuth

      • setAllowPartialAuth

        public void setAllowPartialAuth​(String allowPartialAuth)
        Set to true to authorise a part of the requested amount in case the cardholder does not have enough funds on their account. If a payment was partially authorised, the response includes resultCode: PartiallyAuthorised and the authorised amount in additionalData.authorisedAmountValue. To enable this functionality, contact our Support Team.
        Parameters:
        allowPartialAuth -

      • getAuthorisationType

        public String getAuthorisationType()
        Flags a card payment request for either pre-authorisation or final authorisation. For more information, refer to [Authorisation types](https://docs.adyen.com/online-payments/adjust-authorisation#authorisation-types). Allowed values: * **PreAuth** – flags the payment request to be handled as a pre-authorisation. * **FinalAuth** – flags the payment request to be handled as a final authorisation.
        Returns:
        authorisationType

      • setAuthorisationType

        public void setAuthorisationType​(String authorisationType)
        Flags a card payment request for either pre-authorisation or final authorisation. For more information, refer to [Authorisation types](https://docs.adyen.com/online-payments/adjust-authorisation#authorisation-types). Allowed values: * **PreAuth** – flags the payment request to be handled as a pre-authorisation. * **FinalAuth** – flags the payment request to be handled as a final authorisation.
        Parameters:
        authorisationType -

      • getCustomRoutingFlag

        public String getCustomRoutingFlag()
        Allows you to determine or override the acquirer account that should be used for the transaction. If you need to process a payment with an acquirer different from a default one, you can set up a corresponding configuration on the Adyen payments platform. Then you can pass a custom routing flag in a payment request's additional data to target a specific acquirer. To enable this functionality, contact [Support](https://www.adyen.help/hc/en-us/requests/new).
        Returns:
        customRoutingFlag

      • setCustomRoutingFlag

        public void setCustomRoutingFlag​(String customRoutingFlag)
        Allows you to determine or override the acquirer account that should be used for the transaction. If you need to process a payment with an acquirer different from a default one, you can set up a corresponding configuration on the Adyen payments platform. Then you can pass a custom routing flag in a payment request's additional data to target a specific acquirer. To enable this functionality, contact [Support](https://www.adyen.help/hc/en-us/requests/new).
        Parameters:
        customRoutingFlag -

      • getIndustryUsage

        public AdditionalDataCommon.IndustryUsageEnum getIndustryUsage()
        In case of [asynchronous authorisation adjustment](https://docs.adyen.com/online-payments/adjust-authorisation#adjust-authorisation), this field denotes why the additional payment is made. Possible values: * **NoShow**: An incremental charge is carried out because of a no-show for a guaranteed reservation. * **DelayedCharge**: An incremental charge is carried out to process an additional payment after the original services have been rendered and the respective payment has been processed.
        Returns:
        industryUsage

      • setIndustryUsage

        public void setIndustryUsage​(AdditionalDataCommon.IndustryUsageEnum industryUsage)
        In case of [asynchronous authorisation adjustment](https://docs.adyen.com/online-payments/adjust-authorisation#adjust-authorisation), this field denotes why the additional payment is made. Possible values: * **NoShow**: An incremental charge is carried out because of a no-show for a guaranteed reservation. * **DelayedCharge**: An incremental charge is carried out to process an additional payment after the original services have been rendered and the respective payment has been processed.
        Parameters:
        industryUsage -

      • getManualCapture

        public String getManualCapture()
        Set to **true** to require [manual capture](https://docs.adyen.com/online-payments/capture) for the transaction.
        Returns:
        manualCapture

      • setManualCapture

        public void setManualCapture​(String manualCapture)
        Set to **true** to require [manual capture](https://docs.adyen.com/online-payments/capture) for the transaction.
        Parameters:
        manualCapture -

      • getNetworkTxReference

        public String getNetworkTxReference()
        Allows you to link the transaction to the original or previous one in a subscription/card-on-file chain. This field is required for token-based transactions where Adyen does not tokenize the card. Transaction identifier from card schemes, for example, Mastercard Trace ID or the Visa Transaction ID. Submit the original transaction ID of the contract in your payment request if you are not tokenizing card details with Adyen and are making a merchant-initiated transaction (MIT) for subsequent charges. Make sure you are sending `shopperInteraction` **ContAuth** and `recurringProcessingModel` **Subscription** or **UnscheduledCardOnFile** to ensure that the transaction is classified as MIT.
        Returns:
        networkTxReference

      • setNetworkTxReference

        public void setNetworkTxReference​(String networkTxReference)
        Allows you to link the transaction to the original or previous one in a subscription/card-on-file chain. This field is required for token-based transactions where Adyen does not tokenize the card. Transaction identifier from card schemes, for example, Mastercard Trace ID or the Visa Transaction ID. Submit the original transaction ID of the contract in your payment request if you are not tokenizing card details with Adyen and are making a merchant-initiated transaction (MIT) for subsequent charges. Make sure you are sending `shopperInteraction` **ContAuth** and `recurringProcessingModel` **Subscription** or **UnscheduledCardOnFile** to ensure that the transaction is classified as MIT.
        Parameters:
        networkTxReference -

      • getOverwriteBrand

        public String getOverwriteBrand()
        Boolean indicator that can be optionally used for performing debit transactions on combo cards (for example, combo cards in Brazil). This is not mandatory but we recommend that you set this to true if you want to use the `selectedBrand` value to specify how to process the transaction.
        Returns:
        overwriteBrand

      • setOverwriteBrand

        public void setOverwriteBrand​(String overwriteBrand)
        Boolean indicator that can be optionally used for performing debit transactions on combo cards (for example, combo cards in Brazil). This is not mandatory but we recommend that you set this to true if you want to use the `selectedBrand` value to specify how to process the transaction.
        Parameters:
        overwriteBrand -

      • getSubMerchantCity

        public String getSubMerchantCity()
        This field is required if the transaction is performed by a registered payment facilitator. This field must contain the city of the actual merchant's address. * Format: alpha-numeric. * Maximum length: 13 characters.
        Returns:
        subMerchantCity

      • setSubMerchantCity

        public void setSubMerchantCity​(String subMerchantCity)
        This field is required if the transaction is performed by a registered payment facilitator. This field must contain the city of the actual merchant's address. * Format: alpha-numeric. * Maximum length: 13 characters.
        Parameters:
        subMerchantCity -

      • getSubMerchantCountry

        public String getSubMerchantCountry()
        This field is required if the transaction is performed by a registered payment facilitator. This field must contain the three-letter country code of the actual merchant's address. * Format: alpha-numeric. * Fixed length: 3 characters.
        Returns:
        subMerchantCountry

      • setSubMerchantCountry

        public void setSubMerchantCountry​(String subMerchantCountry)
        This field is required if the transaction is performed by a registered payment facilitator. This field must contain the three-letter country code of the actual merchant's address. * Format: alpha-numeric. * Fixed length: 3 characters.
        Parameters:
        subMerchantCountry -

      • getSubMerchantID

        public String getSubMerchantID()
        This field contains an identifier of the actual merchant when a transaction is submitted via a payment facilitator. The payment facilitator must send in this unique ID. A unique identifier per submerchant that is required if the transaction is performed by a registered payment facilitator. * Format: alpha-numeric. * Fixed length: 15 characters.
        Returns:
        subMerchantID

      • setSubMerchantID

        public void setSubMerchantID​(String subMerchantID)
        This field contains an identifier of the actual merchant when a transaction is submitted via a payment facilitator. The payment facilitator must send in this unique ID. A unique identifier per submerchant that is required if the transaction is performed by a registered payment facilitator. * Format: alpha-numeric. * Fixed length: 15 characters.
        Parameters:
        subMerchantID -

      • getSubMerchantName

        public String getSubMerchantName()
        This field is required if the transaction is performed by a registered payment facilitator. This field must contain the name of the actual merchant. * Format: alpha-numeric. * Maximum length: 22 characters.
        Returns:
        subMerchantName

      • setSubMerchantName

        public void setSubMerchantName​(String subMerchantName)
        This field is required if the transaction is performed by a registered payment facilitator. This field must contain the name of the actual merchant. * Format: alpha-numeric. * Maximum length: 22 characters.
        Parameters:
        subMerchantName -

      • getSubMerchantPostalCode

        public String getSubMerchantPostalCode()
        This field is required if the transaction is performed by a registered payment facilitator. This field must contain the postal code of the actual merchant's address. * Format: alpha-numeric. * Maximum length: 10 characters.
        Returns:
        subMerchantPostalCode

      • setSubMerchantPostalCode

        public void setSubMerchantPostalCode​(String subMerchantPostalCode)
        This field is required if the transaction is performed by a registered payment facilitator. This field must contain the postal code of the actual merchant's address. * Format: alpha-numeric. * Maximum length: 10 characters.
        Parameters:
        subMerchantPostalCode -

      • getSubMerchantState

        public String getSubMerchantState()
        This field is required if the transaction is performed by a registered payment facilitator, and if applicable to the country. This field must contain the state code of the actual merchant's address. * Format: alpha-numeric. * Maximum length: 3 characters.
        Returns:
        subMerchantState

      • setSubMerchantState

        public void setSubMerchantState​(String subMerchantState)
        This field is required if the transaction is performed by a registered payment facilitator, and if applicable to the country. This field must contain the state code of the actual merchant's address. * Format: alpha-numeric. * Maximum length: 3 characters.
        Parameters:
        subMerchantState -

      • getSubMerchantStreet

        public String getSubMerchantStreet()
        This field is required if the transaction is performed by a registered payment facilitator. This field must contain the street of the actual merchant's address. * Format: alpha-numeric. * Maximum length: 60 characters.
        Returns:
        subMerchantStreet

      • setSubMerchantStreet

        public void setSubMerchantStreet​(String subMerchantStreet)
        This field is required if the transaction is performed by a registered payment facilitator. This field must contain the street of the actual merchant's address. * Format: alpha-numeric. * Maximum length: 60 characters.
        Parameters:
        subMerchantStreet -

      • getSubMerchantTaxId

        public String getSubMerchantTaxId()
        This field is required if the transaction is performed by a registered payment facilitator. This field must contain the tax ID of the actual merchant. * Format: alpha-numeric. * Fixed length: 11 or 14 characters.
        Returns:
        subMerchantTaxId

      • setSubMerchantTaxId

        public void setSubMerchantTaxId​(String subMerchantTaxId)
        This field is required if the transaction is performed by a registered payment facilitator. This field must contain the tax ID of the actual merchant. * Format: alpha-numeric. * Fixed length: 11 or 14 characters.
        Parameters:
        subMerchantTaxId -

      • equals

        public boolean equals​(Object o)
        Return true if this AdditionalDataCommon object is equal to o.
        Overrides:
        equals in class Object

      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class Object

      • fromJson

        public static AdditionalDataCommon fromJson​(String jsonString)
                                     throws com.fasterxml.jackson.core.JsonProcessingException
        Create an instance of AdditionalDataCommon given an JSON string
        Parameters:
        jsonString - JSON string
        Returns:
        An instance of AdditionalDataCommon
        Throws:
        com.fasterxml.jackson.core.JsonProcessingException - if the JSON string is invalid with respect to AdditionalDataCommon

      • toJson

        public String toJson()
              throws com.fasterxml.jackson.core.JsonProcessingException
        Convert an instance of AdditionalDataCommon to an JSON string
        Returns:
        JSON string
        Throws:
        com.fasterxml.jackson.core.JsonProcessingException