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

Request

Base URL
https://api-sandbox.interlace.money
URL
https://api-sandbox.interlace.money/open-api/v3/business/account/{accountId}/bank-account
Auth
API key in header x-access-token

Path parameters

accountIdstring required

Request body

nicknamestring required

nickname

purposestring

Purpose of Application

balanceIdstring

Balance Id. Required when the number of VAs exceeds the free limit.

legalEntityIdstring required

Legal entity id

Example request

{
  "nickname": "My Savings Account",
  "legalEntityId": "d8cd0358-156f-4344-9697-08e4f67ce126"
}

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"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.