Skip to content

Simulate Credit Authorization

Simulate credit authorization advice
post/v1/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.

Body Parameters
amountnumber

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.

minimum0
descriptorstring

Merchant descriptor.

maxLength25
minLength1
panstring

Sixteen digit card number.

maxLength16
minLength16
mccstring
optional

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
optional

Unique identifier to identify the payment card acceptor.

maxLength15
minLength1
Returns
tokenstring
optional

A unique token to reference this transaction.

formatuuid
debugging_request_idstring
optional

Debugging request ID to share with Lithic Support team.

formatuuid
Request example Request
curl https://api.lithic.com/v1/simulate/credit_authorization_advice \
    -H 'Content-Type: application/json' \
    -H "Authorization: $LITHIC_API_KEY" \
    -d '{
      "amount": 3831,
      "descriptor": "COFFEE SHOP",
      "pan": "4111111289144142",
      "mcc": "5812",
      "merchant_acceptor_id": "XRKGDPOWEWQRRWU"
    }'
200 Example
{
  "token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "debugging_request_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"
}