Developer Docs
WebsiteDashboard
GuidesAPI ReferenceHelp
PaymentVirtual Account

Apply for a virtual account

POST
/openapi/v1/wallet/virtual-accounts

Apply for a virtual sub-account for an MSO (Money Service Operator) customer. Use it when a payment institution opens a dedicated virtual account for each of its downstream merchants.

Notes

  • After submission, the application requires bank review. Track the application status with the query endpoints
  • After the application succeeds, the virtual account number is returned in the application details

Authorization

bearerAuth
headerAuthorizationBearer <token>

The access_token obtained from POST /oauth2/token. Header format: Authorization: Bearer {accessToken}.

Header Parameters

X-Channel-Provider?string

Provider identifier, such as GLDB. Defaults to GLDB if not passed

Default"GLDB"

Request Body

multipart/form-data
  1. body
masterAccountNo?string

The MSO master account at the provider. If empty, the default master account is used. Length 32

accountName*string

Company name of the MSO customer. Length 128

currency*string

Multiple currencies are supported, separated by commas (for example, SGD,USD). Length 32

contactName*string

Emergency contact name. Length 64

contactEmail*string

Emergency contact email. Length 128

contactPhone*string

Emergency contact phone number in E.164 format (for example, +6591234567). Length 32

companyRegistrationDoc*unknown

Company registration document (for example, COI)

accountOpeningProof?unknown

MSO account opening proof (for example, an account opening letter). If not passed, the default is used

otherDocuments?array<unknown>

Other supporting documents (for example, bank statements or identity documents)

Response Body

Returns the application number and application status.

application/json
  1. response
code?integer

Business status code

message?string
traceId?string

Request trace ID. Provide it when you contact technical support

data?
Example Request
curl -X POST 'https://api.test.stabofx.com/openapi/v1/wallet/virtual-accounts' \  -F 'accountName=Example Trading Pte Ltd' \  -F 'currency=SGD,USD' \  -F 'contactName=Example Contact' \  -F 'contactEmail=contact@example.com' \  -F 'contactPhone=+6500000000' \  -F 'companyRegistrationDoc=<binary file data>' \  -F 'otherDocuments=<binary file data>'
Example Response
{  "code": 200,  "message": "OK",  "traceId": "6a3ae549-32dd-469a-a6b8-4e213c070930",  "data": {    "requestNo": "SA0000000001",    "status": "PENDING"  }}

List virtual accounts GET

Query all opened virtual accounts of the MSO, with pagination.

Retrieve a virtual account GET

Query the details of a virtual account by its virtual account number. The response fields are the same as the elements of the `records` array in List virtual accounts.