Slash API: Create and Manage Virtual Accounts

How to Create and Manage Virtual Accounts with the Slash API

Overview

Virtual accounts let you organize funds within your Slash account. Think of them as sub-wallets under your primary account, each with its own name, balance, and unique account/routing numbers. Using the Slash API, you can programmatically create virtual accounts, check balances, transfer funds between them, and set up automatic commission rules.

Before you begin, you'll need API access enabled on your account and a valid API key.

Key Concepts

• Primary Account: Your main Slash account. In API responses, this appears as a virtual account with accountType: "primary".
• Virtual Account: A sub-account under your primary account, with accountType: "default". Each has its own balance, account number, and routing number.
• Commission Rules: Optional rules that automatically divert a portion of funds from a virtual account to your primary account.

Creating a Virtual Account

Step 1: Get Your Account ID

GET https://api.joinslash.com/account

Step 2: Create the Virtual Account

POST https://api.joinslash.com/virtual-account

Required fields: accountId, name

Optional field: commissionDetails

Listing Virtual Accounts

GET https://api.joinslash.com/virtual-account?filter:accountId=your_account_id

Getting a Single Virtual Account

GET https://api.joinslash.com/virtual-account/{virtualAccountId}

Updating a Virtual Account

PATCH https://api.joinslash.com/virtual-account/{virtualAccountId}

Required field: action (must be "update")

Optional fields: name, commissionDetails

Closing a Virtual Account

PATCH https://api.joinslash.com/virtual-account/{virtualAccountId}

With action: "close"

Transferring Funds Between Virtual Accounts

POST https://api.joinslash.com/transfer/virtual-account

Required fields: source, destination, amountCents

Required header: X-Idempotency-Key

Optional field: memo

Setting Up Commission Rules

Take Rate (Percentage-Based): Diverts a percentage of incoming funds.

Flat Fee: Diverts a fixed amount on a recurring schedule.

Need More Help?

For full API reference documentation, visit https://api.slash.com/openapi.