Simulate a card authorization expiry
Simulate an authorization the merchant never followed through on, so the card network lets it lapse and releases the held funds. Use it to see how your integration handles a hold that quietly goes away instead of settling. The transaction must still be fully open: once any part of it has settled, it can no longer expire. Grid processes the expiry in the background and sends a card transaction webhook once it lands, the same as the other simulators.
Production returns 404 on this path.
Authorizations
API token authentication using format <api token id>:<api client secret>
Path Parameters
The id of the card the expiry applies to.
Body
Sandbox-only request body for simulate endpoints keyed only by an existing card transaction: POST /sandbox/cards/{id}/simulate/return_reversal and POST /sandbox/cards/{id}/simulate/authorization_expiry.
The id of the CardTransaction to act against.
"Transaction:019542f5-b3e7-1d02-0000-000000000100"
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.
Response body for the sandbox card-event simulators. The simulate call pokes the card issuer's sandbox; the resulting card operation is delivered asynchronously via the issuer's events webhook, never synchronously in this response.
The card issuer's transaction token for the simulated event. Correlates the eventual webhook-delivered card operation back to this simulate call.
"f3a1c2d4-5b6e-7890-abcd-ef0123456789"