Get transaction details by reference

GET

https://api.sandbox.vrtx.sa/businesses/accounts/transactions/{transaction_reference}

Last modified:2026-05-31 07:27:13

Retrieves detailed information about a specific fund or payout transaction,
looked up by its external transaction reference (e.g. network ref, ANB ref).

The owning business is resolved from the JWT (businessId claim). A reference
that does not belong to the authenticated business returns 404 so foreign
reference existence is not leaked.

Response includes:

Internal Formance ledger reference (internal_id)

Transaction type, direction, amount, balance, currency

Transaction parties (sender/receiver)

Type-specific fields (description for payouts, FAST/merchant fields for card flows)

Timestamps and audit information

Transaction Types:

Prefund: Money coming into business account from bank (credit)

M2P_Payout: Money going out from business to individual wallet (debit)

Error Scenarios:

404: Transaction reference not found for this business, or account not found

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Responses

🟢200

application/json

Default Response

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🟠405

🟠409

🟠410

🟠422

🟠429

🔴500

🔴501

🔴503

🔴504

🔴505

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.sandbox.vrtx.sa/businesses/accounts/transactions/' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "transaction_reference": "string",
    "transaction_type": "fund",
    "sender_id": "string",
    "receiver_id": "string",
    "amount": "string",
    "balance": "string",
    "direction": "debit",
    "currency": "SAR",
    "created_at": "2019-08-24T14:15:22.123Z",
    "description": "string",
    "status": "Approved",
    "auth_status": "PENDING",
    "merchant": {
        "name": "string",
        "mcc": "string",
        "category": "string",
        "country": "string"
    },
    "network": "string",
    "rrn": "string",
    "terminal_id": "string",
    "fees": {
        "total_fees_excl_vat": "string",
        "vat_amount": "string",
        "total_fees_incl_vat": "string"
    },
    "transaction_amount": "string",
    "transaction_currency": "string",
    "total_amount": "string",
    "internal_id": "string"
}

Modified at 2026-05-31 07:27:13

Get business account balance

List business transactions