1. Card Transactions
Vrtx Docs
  • Card Transactions
    • Perform a simulated card transaction
      POST
    • Perform a balance inquiry
      POST
    • Build a clearing message for settlement
      POST
    • Build and submit clearing to FAST
      POST
    • Send an advisement message
      POST
  • Cards Router Proxy
    • Proxy /fast/settlement to cards-router
      POST
    • Proxy /fast/customer-info to cards-router
      POST
    • Proxy /fast/authorisation to cards-router
      POST
  • Debug Fast
    • Look up clearing event by TID and ADD_REF_RID
      GET
    • Look up auth by TID and ADD_REF_RID
      GET
  • Card Sensitive Data
    • Get card sensitive data
      GET
  • Payouts
    • List payouts
      GET
  • Account Transactions
    • List account transactions (V2)
      GET
Open-Loop-v2Closed-loop V2Card Simulator
open-loop-test
Open-Loop-v2Closed-loop V2Card Simulator
open-loop-test
  1. Card Transactions

Send an advisement message

POST
https://api.staging.vrtx.sa/testhelpers/card-transactions/advise
Last modified:2026-04-14 14:51:07
Sends an ISO 8583 advisement (0120 or 0420) to FAST. Types: auth, preauth, preauth-increment, reversal.

Request

Query Params

Body Params application/jsonRequired

Examples

Responses

🟢200
*/*
OK
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.staging.vrtx.sa/testhelpers/card-transactions/advise?simulate_delay_ms' \
--header 'Content-Type: application/json' \
--data-raw '{
    "advisement_type": "auth",
    "card_id": "550e8400-e29b-41d4-a716-446655440000",
    "tid": "T1699999999123",
    "amount": 25,
    "currency_code": "SAR",
    "acquirer_country": "SAU",
    "tenant_short_code": "VRTX",
    "decision_code": "00",
    "reason_code": "000",
    "decision_desc": "Approve",
    "transaction_type": "UNSPECIFIED",
    "card_use_type": "Chip"
}'
Response Response Example
{
    "tid": "string",
    "rid": "string",
    "status": "UNSPECIFIED"
}
Modified at 2026-04-14 14:51:07
Previous
Build and submit clearing to FAST
Next
Proxy /fast/settlement to cards-router
Built with