Create transfer

POST

https://api.staging.vrtx.sa/cl/v1/transfers

Last modified:2025-12-03 07:59:44

Transfer funds between wallets within the closed-loop ecosystem.
This endpoint debits the sender wallet and credits the receiver wallet, allowing instant internal movement of funds without involving any external banking rails.

Use this endpoint for peer-to-peer (P2P), merchant-to-customer, or customer-to-merchant transactions inside the closed loop.

Transaction Flow

Step	Description	Account	Direction
1	Debit the sender wallet to reflect outgoing funds	Sender Wallet	DEBIT (−)
2	Credit the receiver wallet with the same amount	Receiver Wallet	CREDIT (+)

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Header Params

Body Params application/jsonRequired

Example

{
    "sender_account_number": "088400009010",
    "receiver_account_number": "088400008038",
    "amount": "15.00",
    "currency": "SAR",
    "purpose": "Settlement",
    "external_reference": "Transfer-12312555331",
    "description": "Monthly settlement"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.staging.vrtx.sa/cl/v1/transfers' \
--header 'Idempotency-Key: transfer-req-123' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sender_account_number": "088400009010",
    "receiver_account_number": "088400008038",
    "amount": "15.00",
    "currency": "SAR",
    "purpose": "Settlement",
    "external_reference": "Transfer-12312555331",
    "description": "Monthly settlement"
}'

Responses

🟢201Created

application/json

Created

Body

Example

{
    "id": "ab17f685-3531-46f3-a200-02e9d2d07f41",
    "amount": "1.00",
    "currency": "SAR",
    "purpose": "Settlement",
    "sender_account_number": "054200002027",
    "receiver_account_number": "054200002019",
    "external_reference": "Transfer-1231233",
    "description": "Monthly settlement",
    "status": "SUCCESS",
    "created_at": "2025-10-25T14:37:13.338Z"
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Modified at 2025-12-03 07:59:44

Create refund

Create withdrawal

Create transfer

Transaction Flow#

Request

Request Code Samples

Responses

Transaction Flow