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.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description public final classTransactionSimulateAuthorizationParams.Bodypublic final classTransactionSimulateAuthorizationParams.BuilderA builder for TransactionSimulateAuthorizationParams.
public final classTransactionSimulateAuthorizationParams.StatusType of event to simulate.
AUTHORIZATIONis a dual message purchase authorization, meaning a subsequent clearing step is required to settle the transaction.BALANCE_INQUIRYis 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_AUTHORIZATIONis a dual message request from a merchant to authorize a refund, meaning a subsequent clearing step is required to settle the transaction.FINANCIAL_AUTHORIZATIONis 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_AUTHORIZATIONis a single message request from a merchant to credit funds immediately, and no subsequent clearing is required to settle the transaction.
-
Method Summary
Modifier and Type Method Description final Longamount()Amount (in cents) to authorize. final Stringdescriptor()Merchant descriptor. final Stringpan()Sixteen digit card number. final Optional<String>mcc()Merchant category code for the transaction to be simulated. final Optional<String>merchantAcceptorId()Unique identifier to identify the payment card acceptor. final Optional<Long>merchantAmount()Amount of the transaction to be simulated in currency specified in merchant_currency, including any acquirer fees. final Optional<String>merchantCurrency()3-character alphabetic ISO 4217 currency code. final Optional<Boolean>partialApprovalCapable()Set to true if the terminal is capable of partial approval otherwise false. final Optional<String>pin()Simulate entering a PIN. final Optional<TransactionSimulateAuthorizationParams.Status>status()Type of event to simulate. final JsonField<Long>_amount()Amount (in cents) to authorize. final JsonField<String>_descriptor()Merchant descriptor. final JsonField<String>_pan()Sixteen digit card number. final JsonField<String>_mcc()Merchant category code for the transaction to be simulated. final JsonField<String>_merchantAcceptorId()Unique identifier to identify the payment card acceptor. final JsonField<Long>_merchantAmount()Amount of the transaction to be simulated in currency specified in merchant_currency, including any acquirer fees. final JsonField<String>_merchantCurrency()3-character alphabetic ISO 4217 currency code. final JsonField<Boolean>_partialApprovalCapable()Set to true if the terminal is capable of partial approval otherwise false. final JsonField<String>_pin()Simulate entering a PIN. final JsonField<TransactionSimulateAuthorizationParams.Status>_status()Type of event to simulate. final Map<String, JsonValue>_additionalBodyProperties()final Headers_additionalHeaders()final QueryParams_additionalQueryParams()Headers_headers()The full set of headers in the parameters, including both fixed and additional headers. QueryParams_queryParams()The full set of query params in the parameters, including both fixed and additional query params. final TransactionSimulateAuthorizationParams.BuildertoBuilder()Booleanequals(Object other)IntegerhashCode()StringtoString()final static TransactionSimulateAuthorizationParams.Builderbuilder()Returns a mutable builder for constructing an instance of TransactionSimulateAuthorizationParams. -
-
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.
-
descriptor
final String descriptor()
Merchant descriptor.
-
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.
-
merchantAcceptorId
final Optional<String> merchantAcceptorId()
Unique identifier to identify the payment card acceptor.
-
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.
AUTHORIZATIONis a dual message purchase authorization, meaning a subsequent clearing step is required to settle the transaction.BALANCE_INQUIRYis 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_AUTHORIZATIONis a dual message request from a merchant to authorize a refund, meaning a subsequent clearing step is required to settle the transaction.FINANCIAL_AUTHORIZATIONis 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_AUTHORIZATIONis 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.
-
_descriptor
final JsonField<String> _descriptor()
Merchant descriptor.
-
_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.
-
_merchantAcceptorId
final JsonField<String> _merchantAcceptorId()
Unique identifier to identify the payment card acceptor.
-
_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.
AUTHORIZATIONis a dual message purchase authorization, meaning a subsequent clearing step is required to settle the transaction.BALANCE_INQUIRYis 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_AUTHORIZATIONis a dual message request from a merchant to authorize a refund, meaning a subsequent clearing step is required to settle the transaction.FINANCIAL_AUTHORIZATIONis 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_AUTHORIZATIONis a single message request from a merchant to credit funds immediately, and no subsequent clearing is required to settle the transaction.
-
_additionalBodyProperties
final Map<String, JsonValue> _additionalBodyProperties()
-
_additionalHeaders
final Headers _additionalHeaders()
-
_additionalQueryParams
final QueryParams _additionalQueryParams()
-
_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.
-
toBuilder
final TransactionSimulateAuthorizationParams.Builder toBuilder()
-
builder
final static TransactionSimulateAuthorizationParams.Builder builder()
Returns a mutable builder for constructing an instance of TransactionSimulateAuthorizationParams.
The following fields are required:
.amount() .descriptor() .pan()
-
-
-
-