Simulate a card authorization reversal
Changed onSimulate a merchant cancelling a card authorization before it settles — a hotel releasing a hold, or a store voiding a purchase that never went through. Use it to see how your integration handles an authorization that disappears without ever clearing. Send amount to reverse only part of the authorization, or leave it out to reverse all of it. The transaction must still be fully open: once any part of it has settled, it can no longer be reversed. Grid processes the reversal in the background. A full reversal sets status: VOIDED and sends a CARD_TRANSACTION.VOIDED webhook. A partial reversal leaves the transaction AUTHORIZED with a smaller hold.
Production returns 404 on this path.
Request
- Base URLhttps://api.lightspark.com/grid/2025-10-13
- URLhttps://api.lightspark.com/grid/2025-10-13/sandbox/cards/{id}/simulate/authorization_reversal
- AuthHTTP basic
Path parameters
The id of the card the reversal applies to.
Request body
Example request
{
"cardTransactionId": "Transaction:019542f5-b3e7-1d02-0000-000000000100",
"amount": 1250
}Response
Simulation accepted. The resulting card operation is delivered asynchronously via the issuer's events webhook. Returns the issuer transaction token that correlates the simulated event.
Example response
{
"issuerTransactionToken": "f3a1c2d4-5b6e-7890-abcd-ef0123456789"
}Changes
- info
added the optional property
/to the response with the status - info
added the optional property
/to the response with the status - info
added the optional property
/to the response with the status - info
added the optional property
/to the response with the status - info
added the optional property
/to the response with the status
- info
- warning
added the new
CORRIDOR_UNDER_MAINTENANCEenum value to theresponse property for the response status
- warning