vrtx Docs
Core APIs
  • Start
  • Onboarding
  • Wallet
  • Payouts
  • Cards
  • Transactions
Closed loop APIsCard Simulator
SDK APIs
  • Coming Soon!
Core APIs
  • Start
  • Onboarding
  • Wallet
  • Payouts
  • Cards
  • Transactions
Closed loop APIsCard Simulator
SDK APIs
  • Coming Soon!
  1. Card Transactions
  • Card Transactions
    • Perform a simulated card transaction
      POST
    • Perform a balance inquiry
      POST
  1. Card Transactions

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
{
    "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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
cURL
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
Next
Perform a balance inquiry
Built with