Sign in

v51

OpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-07-092154381.1 MB
Transaction

Simulate return

Returns, or refunds, an amount back to a card. Returns simulated via this endpoint clear immediately, without prior authorization, and result in a SETTLED transaction status.

post/v1/simulate/return

Request body

amountinteger required

Amount (in cents) to authorize.

descriptorstring required

Merchant descriptor.

panstring required

Sixteen digit card number.

Example request

{
  "descriptor": "COFFEE SHOP",
  "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.