Sub Account APIs

Create Sub Account

POST /abc/v1/sub-account/create

Create Sub Account

Request Headers

X-API-Key

string

Description

example

{apiKey}

X-Timestamp

integer

Description

example

{{Timestamp}}

X-Nonce

string

Description

example

{{Nonce}}

X-Signature

string

Description

example

{{Signature}}

Content-Type

string

Description

example

application/json

Request Body

Data model: OpenSubAccountCreateRequest

subAccountName

stringRequired

Description

sub account name

Example / Default

RD-SubAccount

currency

string

Description

currency

Example / Default

USD

subAccountAmount

number

Description

Initial amount (unit: cents)

Example / Default

10000

parentAccountId

string

Description

Primary account wallet ID

Successful Response

Data model: CommonResultOpenSubAccountResponse

code

integer

Description

Error code

msg

string

Description

Human-readable error message

message

string

Description

data

object (OpenSubAccountResponse)

Description

data structure (OpenSubAccountResponse)

subAccountId

string

Description

sub account unique ID

subAccountName

string

Description

sub account name

parentAccountId

string

Description

primary account ID

currency

string

Description

currency

Example / Default

USD

status

integer

Description

account status: 1=active, 2=closed, 3=frozen

bookAmount

number

Description

Book amount (cents)

availableAmount

number

Description

Available amount (cents)

spendAmount

number

Description

Spent amount (cents)

budgetAvailableLimit

number

Description

Available budget limit (cents)

budgetTotalLimit

number

Description

Total budget limit (cents)

createTime

string

Description

creation time

frozenAmount

number

Description

Frozen amount, unit: cents (minor unit), integer

Query Sub Accounts

POST /abc/v1/sub-account/query

Query Sub Accounts

Request Headers

X-API-Key

string

Description

example

{apiKey}

X-Timestamp

integer

Description

example

{{Timestamp}}

X-Nonce

string

Description

example

{{Nonce}}

X-Signature

string

Description

example

{{Signature}}

Content-Type

string

Description

example

application/json

Request Body

Data model: OpenSubAccountPageRequest

pageNo

integerRequired

Description

Page number, starting from 1; minimum 1

Example / Default

pageSize

integerRequired

Description

Items per page, maximum 200; minimum 1

Example / Default

subAccountId

string

Description

sub account ID

Example / Default

SUB_001

subAccountName

string

Description

sub account name

Example / Default

R&D sub account

Successful Response

Data model: CommonResultPageResultOpenSubAccountResponse

code

integer

Description

Error code

msg

string

Description

Human-readable error message

message

string

Description

data

object (PageResultOpenSubAccountResponse)

Description

data structure (PageResultOpenSubAccountResponse)

total

integer (int64)

Description

Total

list

array<object (OpenSubAccountResponse)>

Description

Data

Sub Account Details

POST /abc/v1/sub-account/detail

Sub Account Details

Request Headers

X-API-Key

string

Description

example

{apiKey}

X-Timestamp

integer

Description

example

{{Timestamp}}

X-Nonce

string

Description

example

{{Nonce}}

X-Signature

string

Description

example

{{Signature}}

Content-Type

string

Description

example

application/json

Request Body

Data model: OpenSubAccountDetailRequest

subAccountId

stringRequired

Description

sub account ID

Example / Default

SUB_001

Successful Response

Data model: CommonResultOpenSubAccountResponse

code

integer

Description

Error code

msg

string

Description

Human-readable error message

message

string

Description

data

object (OpenSubAccountResponse)

Description

data structure (OpenSubAccountResponse)

subAccountId

string

Description

sub account unique ID

subAccountName

string

Description

sub account name

parentAccountId

string

Description

primary account ID

currency

string

Description

currency

Example / Default

USD

status

integer

Description

account status: 1=active, 2=closed, 3=frozen

bookAmount

number

Description

Book amount (cents)

availableAmount

number

Description

Available amount (cents)

spendAmount

number

Description

Spent amount (cents)

budgetAvailableLimit

number

Description

Available budget limit (cents)

budgetTotalLimit

number

Description

Total budget limit (cents)

createTime

string

Description

creation time

frozenAmount

number

Description

Frozen amount, unit: cents (minor unit), integer

Enable or Disable Sub Account

POST /abc/v1/sub-account/update-status

Enable or Disable Sub Account

Request Headers

X-API-Key

string

Description

example

{apiKey}

X-Timestamp

integer

Description

example

{{Timestamp}}

X-Nonce

string

Description

example

{{Nonce}}

X-Signature

string

Description

example

{{Signature}}

Content-Type

string

Description

example

application/json

Request Body

Data model: OpenSubAccountStatusUpdateRequest

subAccountId

stringRequired

Description

sub account ID

Example / Default

SUB_001

accountStatus

integerRequired

Description

Target account status: 1=enabled, 4=disabled

Example / Default

disableReason

string

Description

Disable reason; recommended when accountStatus=4

Example / Default

BUSINESS_LINE_CLOSED

remark

string

Description

operation remark

Example / Default

Business line closed; sub account disabled

Successful Response

Data model: CommonResultOpenSubAccountResponse

code

integer

Description

Error code

msg

string

Description

Human-readable error message

message

string

Description

data

object (OpenSubAccountResponse)

Description

data structure (OpenSubAccountResponse)

subAccountId

string

Description

sub account unique ID

subAccountName

string

Description

sub account name

parentAccountId

string

Description

primary account ID

currency

string

Description

currency

Example / Default

USD

status

integer

Description

account status: 1=active, 2=closed, 3=frozen

bookAmount

number

Description

Book amount (cents)

availableAmount

number

Description

Available amount (cents)

spendAmount

number

Description

Spent amount (cents)

budgetAvailableLimit

number

Description

Available budget limit (cents)

budgetTotalLimit

number

Description

Total budget limit (cents)

createTime

string

Description

creation time

frozenAmount

number

Description

Frozen amount, unit: cents (minor unit), integer

Update Sub Account Name

POST /abc/v1/sub-account/update-name

Update Sub Account Name

Request Headers

X-API-Key

string

Description

example

{apiKey}

X-Timestamp

integer

Description

example

{{Timestamp}}

X-Nonce

string

Description

example

{{Nonce}}

X-Signature

string

Description

example

{{Signature}}

Content-Type

string

Description

example

application/json

Request Body

Data model: OpenSubAccountUpdateNameRequest

subAccountId

stringRequired

Description

sub account ID

Example / Default

SUB_001

subAccountName

stringRequired

Description

new sub account name

Example / Default

R&D sub account

Successful Response

Data model: CommonResultBoolean

code

integer

Description

Error code

msg

string

Description

Human-readable error message

message

string

Description

data

boolean

Description

Response data

Query Sub Account Fund Flows

POST /abc/v1/sub-account/flow/query

Query Sub Account Fund Flows

Request Headers

X-API-Key

string

Description

example

{apiKey}

X-Timestamp

integer

Description

example

{{Timestamp}}

X-Nonce

string

Description

example

{{Nonce}}

X-Signature

string

Description

example

{{Signature}}

Content-Type

string

Description

example

application/json

Request Body

Data model: OpenSubAccountFlowQueryRequest

pageNo

integerRequired

Description

Page number, starting from 1; minimum 1

Example / Default

pageSize

integerRequired

Description

Items per page, maximum 200; minimum 1

Example / Default

subAccountFlowId

string

Description

sub account fund flow ID

Example / Default

SF20260101000001

subAccountId

string

Description

sub account ID

Example / Default

SUB_001

subAccountName

string

Description

sub account name

Example / Default

R&D sub account

currency

string

Description

currency code ISO 4217

Example / Default

USD

transType

integer

Description

Transaction type: 1=outgoing transfer, 2=incoming transfer, 3=purchase, 4=purchase refund, 5=freeze, 6=unfreeze, 7=adjustment increase, 8=adjustment decrease, 9=budget allocation

Example / Default

transStatus

integer

Description

Transaction status: 1=success, 2=failure, 3=pending, 4=processing; minimum 1; maximum 4

Example / Default

transactionTime

arraystring>

Description

Transaction time range, an array with two elements: [start time, end time]

Successful Response

Data model: CommonResultPageResultOpenSubAccountFlowResponse

code

integer

Description

Error code

msg

string

Description

Human-readable error message

message

string

Description

data

object (PageResultOpenSubAccountFlowResponse)

Description

data structure (PageResultOpenSubAccountFlowResponse)

total

integer (int64)

Description

Total

list

array<object (OpenSubAccountFlowResponse)>

Description

Data

switch sub account card provider

POST /abc/v1/sub-account/switch-provider

Switch Sub Account Card Provider

Request Headers

X-API-Key

stringRequired

Description

API key

example

{APIKey}

X-Timestamp

integerRequired

Description

Unix timestamp in seconds

example

{{Timestamp}}

X-Nonce

stringRequired

Description

Request nonce

example

{{Nonce}}

X-Signature

stringRequired

Description

Request signature

example

{{Signature}}

Content-Type

stringRequired

Description

Request content type

example

application/json

Request Body

Request body format: application/json

subAccountId

stringRequired

Description

Sub account ID, maximum length 64 characters

Example or Default

SUB_001

targetProviderName

stringRequired

Description

Target card provider ID. Use an available channel ID provided by ORBSIS.

Example or Default

ORBSIS_A

Available card provider IDs are based on the configuration provided by ORBSIS.

Request Body Example

{ "subAccountId": "SUB_001", "targetProviderName": "ORBSIS_A" }

cURL Example

curl --request POST 'https://open.orbsis.com/abc/v1/sub-account/switch-provider' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: api-key' \
  --header 'X-Timestamp: unix-seconds' \
  --header 'X-Nonce: unique-nonce' \
  --header 'X-Signature: base64-signature' \
  --data '{"subAccountId":"SUB_001","targetProviderName":"ORBSIS_A"}'

Successful Response

HTTP Status Code: 200

After the switch succeeds, the response body is an empty object.

Create Sub Account​

Query Sub Accounts​

Sub Account Details​

Enable or Disable Sub Account​

Update Sub Account Name​

Query Sub Account Fund Flows​

switch sub account card provider​

Create Sub Account

Query Sub Accounts

Sub Account Details

Enable or Disable Sub Account

Update Sub Account Name

Query Sub Account Fund Flows

switch sub account card provider