Class TransactionSimulateAuthorizationParams

  • All Implemented Interfaces:
    com.lithic.api.core.Params

    
    public final class TransactionSimulateAuthorizationParams
     implements Params
                        

    Simulates an authorization request from the card network as if it came from a merchant acquirer. If you are configured for ASA, simulating authorizations requires your ASA client to be set up properly, i.e. be able to respond to the ASA request with a valid JSON. For users that are not configured for ASA, a daily transaction limit of $5000 USD is applied by default. You can update this limit via the update account endpoint.

    • Constructor Detail

    • Method Detail

      • amount

         final Long amount()

        Amount (in cents) to authorize. For credit authorizations and financial credit authorizations, any value entered will be converted into a negative amount in the simulated transaction. For example, entering 100 in this field will result in a -100 amount in the transaction. For balance inquiries, this field must be set to 0.

      • pan

         final String pan()

        Sixteen digit card number.

      • mcc

         final Optional<String> mcc()

        Merchant category code for the transaction to be simulated. A four-digit number listed in ISO 18245. Supported merchant category codes can be found here.

      • merchantAmount

         final Optional<Long> merchantAmount()

        Amount of the transaction to be simulated in currency specified in merchant_currency, including any acquirer fees.

      • merchantCurrency

         final Optional<String> merchantCurrency()

        3-character alphabetic ISO 4217 currency code. Note: Simulator only accepts USD, GBP, EUR and defaults to GBP if another ISO 4217 code is provided

      • partialApprovalCapable

         final Optional<Boolean> partialApprovalCapable()

        Set to true if the terminal is capable of partial approval otherwise false. Partial approval is when part of a transaction is approved and another payment must be used for the remainder.

      • pin

         final Optional<String> pin()

        Simulate entering a PIN. If omitted, PIN check will not be performed.

      • status

         final Optional<TransactionSimulateAuthorizationParams.Status> status()

        Type of event to simulate.

        • AUTHORIZATION is a dual message purchase authorization, meaning a subsequent clearing step is required to settle the transaction.

        • BALANCE_INQUIRY is a $0 authorization requesting the balance held on the card, and is most often observed when a cardholder requests to view a card's balance at an ATM.

        • CREDIT_AUTHORIZATION is a dual message request from a merchant to authorize a refund, meaning a subsequent clearing step is required to settle the transaction.

        • FINANCIAL_AUTHORIZATION is a single message request from a merchant to debit funds immediately (such as an ATM withdrawal), and no subsequent clearing is required to settle the transaction.

        • FINANCIAL_CREDIT_AUTHORIZATION is a single message request from a merchant to credit funds immediately, and no subsequent clearing is required to settle the transaction.

      • _amount

         final JsonField<Long> _amount()

        Amount (in cents) to authorize. For credit authorizations and financial credit authorizations, any value entered will be converted into a negative amount in the simulated transaction. For example, entering 100 in this field will result in a -100 amount in the transaction. For balance inquiries, this field must be set to 0.

      • _mcc

         final JsonField<String> _mcc()

        Merchant category code for the transaction to be simulated. A four-digit number listed in ISO 18245. Supported merchant category codes can be found here.

      • _merchantAmount

         final JsonField<Long> _merchantAmount()

        Amount of the transaction to be simulated in currency specified in merchant_currency, including any acquirer fees.

      • _merchantCurrency

         final JsonField<String> _merchantCurrency()

        3-character alphabetic ISO 4217 currency code. Note: Simulator only accepts USD, GBP, EUR and defaults to GBP if another ISO 4217 code is provided

      • _partialApprovalCapable

         final JsonField<Boolean> _partialApprovalCapable()

        Set to true if the terminal is capable of partial approval otherwise false. Partial approval is when part of a transaction is approved and another payment must be used for the remainder.

      • _pin

         final JsonField<String> _pin()

        Simulate entering a PIN. If omitted, PIN check will not be performed.

      • _status

         final JsonField<TransactionSimulateAuthorizationParams.Status> _status()

        Type of event to simulate.

        • AUTHORIZATION is a dual message purchase authorization, meaning a subsequent clearing step is required to settle the transaction.

        • BALANCE_INQUIRY is a $0 authorization requesting the balance held on the card, and is most often observed when a cardholder requests to view a card's balance at an ATM.

        • CREDIT_AUTHORIZATION is a dual message request from a merchant to authorize a refund, meaning a subsequent clearing step is required to settle the transaction.

        • FINANCIAL_AUTHORIZATION is a single message request from a merchant to debit funds immediately (such as an ATM withdrawal), and no subsequent clearing is required to settle the transaction.

        • FINANCIAL_CREDIT_AUTHORIZATION is a single message request from a merchant to credit funds immediately, and no subsequent clearing is required to settle the transaction.

      • _headers

         Headers _headers()

        The full set of headers in the parameters, including both fixed and additional headers.

      • _queryParams

         QueryParams _queryParams()

        The full set of query params in the parameters, including both fixed and additional query params.