Perform a simulated card transaction

POST

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

Last modified:2025-12-04 11:19:56

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

Request

Body Params application/jsonRequired

Examples

POS purchase in Saudi ArabiaE-commerce purchase in Saudi Arabia

POS

{
    "transaction_type": "POS",
    "card_id": "550e8400-e29b-41d4-a716-446655440000",
    "acquirer_country": "KSA",
    "amount": "150.75",
    "currency_code": "SAR"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

POS purchase in Saudi ArabiaE-commerce purchase in Saudi Arabia

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

Responses

🟢200OK

application/json

FAST processed the transaction

Body

Example

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

🟠400Bad Request

🔴500Internal Server Error

Modified at 2025-12-04 11:19:56

Perform a balance inquiry