Simulate a card financial authorization
Simulate a single-message financial authorization (an authorization that clears in the same message, e.g. an ATM withdrawal or other dual-message-exempt flow) against a card in the sandbox environment. Drives the same internal paths the card issuer would call in production. The resulting card operation is delivered asynchronously via the issuer’s events webhook.
As with simulate/authorization, the decisioning outcome is controlled by the last three characters of merchant.descriptor — see the simulate/authorization suffix table.
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 to simulate a financial authorization against.
Body
Sandbox-only request body shared by the card authorization-family simulate endpoints: simulate/authorization, simulate/credit_authorization, simulate/financial_authorization, simulate/financial_credit_authorization, and simulate/credit_authorization_advice. Drives the same internal authorization + reconcile paths that the issuer would call in production. The decisioning outcome is controlled by the last three characters of merchant.descriptor — see the simulate/authorization documentation for the suffix table.
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"