Sign in

v1

latestOpenAPI 3.0.12026-07-24128351404.9 KB
Account Onboarding

Create Virtual Account

Creates and links a new Virtual Account (VA) to the business account.

post/open-api/v3/business/account/{accountId}/bank-account

Path parameters

accountIdstring required

Request body

nicknamestring required

nickname

purposestring

Purpose of Application

Example request

{
  "nickname": "My Savings Account"
}

Response

success

codestring

Business code, 000000 means success

messagestring

Message description

Example response

{
  "code": "000000",
  "message": "success",
  "data": {
    "id": "cae9efe2-b577-4632-8c57-8822ddb8542a",
    "accountId": "cae9efe2-b577-4632-8c57-8822ddb8542a",
    "createTime": "1755498145103",
    "nickname": "My Business Account",
    "purpose": "General Business Operations",
    "currency": "USD",
    "balanceId": "b1a2c3d4-e5f6-7890-abcd-ef1234567890",
    "bankAccounts": [
      {
        "accountId": "cae9efe2-b577-4632-8c57-8822ddb8542a",
        "createTime": "1755498145103",
        "accountName": "John Doe",
        "accountNo": "123456789",
        "currency": "USD",
        "bankName": "Bank of Examples",
        "bankAddress": {
          "addressLine1": "123 Main St",
          "addressLine2": "Apt 4B",
          "city": "New York",
          "country": "US",
          "postalCode": "10001"
        },
        "swift": "BOFAUS3N",
        "routingNumber": "026009593",
        "routingType": "ABA",
        "branchName": "Downtown Branch",
        "branchCode": "123456",
        "status": "ACTIVE"
      }
    ]
  }
}