Simulate a card authorization advice

Simulate an AUTHORIZATION_ADVICE that re-sizes an existing open authorization on a CardTransaction in the sandbox environment. The amount is the new total authorized amount the advice re-sizes to. The parent transaction must be in AUTHORIZED or PARTIALLY_SETTLED state. The resulting card operation is delivered asynchronously via the issuer’s events webhook.

Production returns 404 on this path.

POST /sandbox/cards/{id}/simulate/authorization_advice

Simulate a card authorization advice

cURL

curl --request POST \
  --url https://api.lightspark.com/grid/2025-10-13/sandbox/cards/{id}/simulate/authorization_advice \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cardTransactionId": "Transaction:019542f5-b3e7-1d02-0000-000000000100",
  "amount": 2000
}
'

202

{
  "issuerTransactionToken": "f3a1c2d4-5b6e-7890-abcd-ef0123456789"
}

Authorizations

Authorization · string · header · required

API token authentication using format <api token id>:<api client secret>

Path Parameters

id · string · required

The id of the card the advice applies to.

Body

application/json

Sandbox-only request body for POST /sandbox/cards/{id}/simulate/authorization_advice. Drives an AUTHORIZATION_ADVICE that re-sizes an existing open authorization.

cardTransactionId · string · required

The id of the CardTransaction the advice re-sizes. Must be in AUTHORIZED or PARTIALLY_SETTLED state.

Example:

"Transaction:019542f5-b3e7-1d02-0000-000000000100"

amount · integer<int64> · required

The new total authorized amount, in the smallest unit of the transaction's currency, that the advice re-sizes the authorization to.

Example:

2000

Response

202

application/json

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.

issuerTransactionToken · string · required

The card issuer's transaction token for the simulated event. Correlates the eventual webhook-delivered card operation back to this simulate call.

Example:

"f3a1c2d4-5b6e-7890-abcd-ef0123456789"