Transaction

Simulate credit authorization advice

Changed on

Simulates a credit authorization advice from the card network. This message indicates that the network approved a credit authorization on your behalf.

post/v1/simulate/credit_authorization_advice

Request

  • Base URL
    https://sandbox.lithic.com
  • URL
    https://sandbox.lithic.com/v1/simulate/credit_authorization_advice
  • Auth
    API key in header Authorization

Request body

amountinteger required

Amount (in cents). Any value entered will be converted into a negative amount in the simulated transaction. For example, entering 100 in this field will appear as a -100 amount in the transaction.

billing_currencystring

3-character alphabetic ISO 4217 currency code for the cardholder billing amount. Permitted values are USD, GBP, EUR and CAD, and any other ISO 4217 code returns a 422. Defaults to USD

descriptorstring required

Merchant descriptor.

mccstring

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.

merchant_acceptor_idstring

Unique identifier to identify the payment card acceptor.

merchant_acceptor_citystring

Merchant acceptor city

merchant_acceptor_statestring

Merchant acceptor state/province (ISO 3166-2 subdivision code)

merchant_acceptor_countrystring

Merchant acceptor country code (ISO 3166-1 alpha-3)

panstring required

Sixteen digit card number.

Example request

{
  "billing_currency": "CAD",
  "descriptor": "COFFEE SHOP",
  "mcc": "5812",
  "merchant_acceptor_id": "XRKGDPOWEWQRRWU",
  "merchant_acceptor_city": "SEATTLE",
  "merchant_acceptor_state": "WA",
  "merchant_acceptor_country": "USA",
  "pan": "4111111289144142"
}

Response

OK

debugging_request_idstring uuid

Debugging request ID to share with Lithic Support team.

tokenstring uuid

A unique token to reference this transaction.

Changes