Sign in

v66

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-042174421.1 MB
Transaction

Simulate credit authorization advice

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 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.

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

{
  "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.