packages/api-specs/server-api-v2/src/publicApi

// This builds the mint.json file for the given environment
// and merges the mint.config.json file for that environment
// into the mint.json file.
const env = process.argv.slice(2)[0];

const environment = env ?? 'production';

const path = require('node:path');
const mintJson = require('../mint.json');

const config = require('../mint.config.json')[environment];
const { writeFileSync } = require('node:fs');

if (!config) {
  throw new Error(`No config found for environment ${environment}`);
}

writeFileSync(
  path.resolve(__dirname, '../mint.json'),
  JSON.stringify(deepMerge(mintJson, config), undefined, 2)
);

function deepMerge(a, b) {
  return Object.fromEntries(
    Object.entries(a).map(([key, value]) => {
      if (key in b) {
        if (
          typeof value === 'object' &&
          typeof b[key] === 'object' &&
          !!value &&
          !!b[key]
        ) {
          return [key, deepMerge(value, b[key])];
        }

        return [key, b[key]];
      }

      return [key, value];
    })
  );
}


// this script checks that the mint.json file is using
// the production URL

const productionConfig = require('../mint.config.json').production;
const mintJson = require('../mint.json');

const red = '\x1b[31m';
const reset = '\x1b[0m';

if (productionConfig.openapi !== mintJson.openapi) {
  console.log(
    `${red}mint.json is not using the production URL. Run yarn docs:build:prod${reset}`
  );
  process.exit(1);
}


Create virtual account

Money

The amount of money to be diverted from the virtual account if the type of rule is flat_fee.

The frequency from the start date that the rule will be applied. E.g. a start date of November 26, 2024 with a frequency of "monthly"
will have the rule applied on December 26, 2024. If the frequency was "yearly", the rule would be applied again on November 26, 2025.


The date that the rule will begin to take effect.

The type of the commission rule. A type of flat_fee will take a flat fee from the virtual account and transfer it to the primary account
with the frequency of the collection defined as monthly or yearly.


The percentage of funds to divert from the virtual account to the primary account.

The type of the commission rule. A type of take_rate will take a percent of the virtual account's funds and divert them to
the primary account.


VirtualAccountCommissionDetails

The virtual account commission rule object

Describes details of the commission rule.

The ID of the virtual account the commission rule is applied to

VirtualAccountCommissionRule

The account ID of the Slash account the virtual account is associated with.

The account number of the virtual account.

The account type of the virtual account. Since virtual accounts and Slash accounts exist at the same hierarchy level,
an account type of 'primary' means it is the main Slash account, while an account type of 'default' means it is a virtual account
under the main account.


The date the virtual account was closed; will be null if account was never closed.

The routing number of the virtual account.

VirtualAccountModel

api key

bearer

Error

Create a virtual account

Slash

Use the Slash API to access your account, transactions, cards and more.

Getting Started

Changelog

Legal Entity

Account

Virtual Account

Balance

Card

Transaction

Spending Constraint

Slash Handle

Card Group

Webhook

Webhook Event

Card Group Utilization

Authorization Webhook

Authorization Request Event

Authorization Webhook Response

List all legal entities you have access to

List legal entities

List accounts

Get account

Retrieve a list of balances for an account. 
The balances are returned in an array, with each item representing a balance for that account.

For charge_card accounts, there will be two balances returned: "cash" and "credit".
For debit accounts, there will only be one balance returned: "debit".


List account balances

Use authorization webhooks to approve or decline card transactions in real-time.

Authorization Webhook Overview

Retrieve the authorization webhook configuration for an account.
This webhook is called during card authorization requests to allow external systems
to approve or reject transactions in real-time.


Get account authorization webhook

Create or update the authorization webhook configuration for an account. This will upsert the webhook configuration, creating it if it doesn't exist or updating it if it does. 

The secret for a webhook remains static after it is initially created. If you would like to retrieve the secret before sending requests,
create the authorization webhook in status 'inactive' first and then update it to 'active' after.


Set account authorization webhook

Partially update the authorization webhook configuration for an account.
Only the provided fields will be updated.


Partially update account authorization webhook

Retrieve a list of virtual accounts under an account.
The virtual accounts are returned in an array, with each item representing a virtual account under that account.

The primary account will also be returned as a virtual account, with an account type of 'primary' while actual subaccounts
under the primary account will have an account type of 'default'.


List virtual accounts

Retrieve a single virtual account by its ID.


Get virtual account

Update virtual account

List transactions

Get transaction aggregations

Fetch details for a single transaction by ID

Get transaction

Get transaction fee details

Add or update a note for a transaction

Transfer money between Virtual Accounts or fund a Virtual Account from a Primary Account