Perform a simulated card transaction

POST

https://api.staging.vrtx.sa/testhelpers/card-transactions

Last modified:2026-04-14 14:51:07

Sends a realistic ISO8583 authorization to FAST and returns a summarized result.

Request

Query Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

FAST processed the transaction

Body

🟠400Bad Request

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

cURL

POS purchase in Saudi ArabiaE-commerce purchase in Saudi ArabiaForeign transaction amount with SAR billing (FAST)

curl --location --request POST 'https://api.staging.vrtx.sa/testhelpers/card-transactions?simulate_delay_ms' \
--header 'Content-Type: application/json' \
--data-raw '{
    "transaction_type": "POS",
    "card_id": "550e8400-e29b-41d4-a716-446655440000",
    "acquirer_country": "SAU",
    "amount": "150.75",
    "currency_code": "SAR"
}'

Response Example

{
    "tid": "string",
    "rid": "string",
    "status": "UNSPECIFIED"
}

Modified at 2026-04-14 14:51:07

Perform a balance inquiry