Simulate Card Authorization

post

https://api.stage.mbanq.cloud/v1/cards/simulations/{cardId}/authorization

Sandbox-only simulator endpoint for card authorizations.

Use this universal endpoint to simulate purchases, pre-authorizations, ATM withdrawals, cash advances, merchant credits, card payments, balance inquiries, quasi-cash transactions, advice messages, and reversals. The authType and transactionType fields determine the simulated authorization behavior.

Path Params

cardId

integer

required

Identifier of the simulated card returned by POST /v1/cards/simulations.

Body Params

externalAuthId

string

required

externalOriginalAuthId

string

amount

double

required

currency

string

required

authType

string

enum

required

Allowed:

transactionType

string

enum

required

amountDetails

object

merchant

object

required

international

boolean

network

string

required

expiryDate

date

executionCode

string

executionMessage

string

status

string

enum

required

Allowed:

flag

string

incremental

boolean

Headers

instance

string

required

Defaults to default

The banking instance identifier. Use default for staging simulations.

Responses

400

The request failed validation.

401

Authentication credentials were missing or incorrect.

403

The authenticated user does not have permission to simulate card authorizations.

404

The specified simulated card was not found.

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The simulated authorization was processed successfully.