Create business

POST

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

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

Create a business entity in the closed-loop ecosystem.
When a business is created, the system automatically provisions an operational account and the corresponding wallet structure required for managing funds internally.

This setup enables the business to participate in the closed-loop environment — allowing wallet creation, payouts, and internal transfers without connecting to external banking rails.

Account Structure

Account Type	Description	Ownership	Example
Clearance Account	Tracks all reconciliation and settlement inflows/outflows.	System / Business	`000019283740`
Operational Account	Holds the business’ active funds for payouts and internal transfers.	Business	`100019283740`

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Body Params application/jsonRequired

Example

{
    "unified_number": "7009873774",
    "cr_number": "1234567811",
    "official_name_ar": "شركة فرتكس العربية",
    "official_name_en": "Vrtx Arabia Trading Co.",
    "short_name_ar": "فرتكس العربية",
    "short_name_en": "Vrtx KSA",
    "cr_expiry_date": "2025-12-31T00:00:00.000Z",
    "email": "ops@vrtx.sa",
    "mobile": "+966501234567",
    "status": "ACTIVE"
}

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/businesses' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "unified_number": "7009873774",
    "cr_number": "1234567811",
    "official_name_ar": "شركة فرتكس العربية",
    "official_name_en": "Vrtx Arabia Trading Co.",
    "short_name_ar": "فرتكس العربية",
    "short_name_en": "Vrtx KSA",
    "cr_expiry_date": "2025-12-31T00:00:00.000Z",
    "email": "ops@vrtx.sa",
    "mobile": "+966501234567",
    "status": "ACTIVE"
}'

Responses

🟢201Created

application/json

Body

Example

{
    "id": "85fee10b-e47f-46c6-b5c3-e0d34c5060b3",
    "unified_number": "7000102991",
    "cr_number": "1234567897",
    "official_name_ar": "شركة فرتكس العربية",
    "official_name_en": "Vrtx Arabia Trading Co.",
    "short_name_ar": "فرتكس العربية",
    "short_name_en": "Vrtx KSA",
    "cr_expiry_date": "2025-12-31T00:00:00.000Z",
    "email": "ops@vrtx.sa",
    "mobile": "+966501234567",
    "prefix3": "103",
    "account_number": "010300006011",
    "status": "ACTIVE",
    "created_at": "2025-10-25T12:35:16.446Z",
    "updated_at": "2025-10-25T12:35:16.446Z"
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

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

List businesses

Create fund

Create business

Account Structure#

Request

Request Code Samples

Responses

Account Structure