Skip to content

Quick start

Here’s an overview of how you can get up and running with Moov using Moov.js, our in-browser JavaScript SDK. To get started on our platform, you’ll need to:

  • Create an account
  • Get your API keys
  • Create an access token

After completing these steps, you’ll be ready to link a bank account and initiate a transfer, which we’ll also cover in this guide.

Be sure to read up on Moov’s core concepts.

Create an account

If you don’t already have an account, create one here.

Get API keys

Once you have an account with Moov, you can retrieve your API keys. Set the permissions you want to designate for your API key.

Create an access token

Within your server-side application, you’ll generate a single-use access token that contains information needed to securely communicate with your Moov account. Once you’ve generated this token, you can use it to make calls from the server or send it back to your client to use with Moov.js.

How to create an access token

Once you’ve completed these three steps, you’re set up to start moving money by adding accounts to pay, linking your bank account, and initiating a transfer.

Add an account to pay

To start paying others, you can set up others with Moov accounts. If you’d like to link a Moov account to an account in your system, you have the option to pass a foreign ID.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
moov.accounts.create({
  "accountType": "business",
  "foreignID": "your-optional-user-id",
  "profile": {
    "business": {
      "legalBusinessName": "Whole Body Fitness LLC",
      "businessType": "llc",
    }
  }
})

In order to move funds, you’ll need to link a bank account. Once the linked bank account has been verified, you are ready to move money.

1
2
3
4
5
6
7
8
9
const accountID = accountID;
const bankAccount = {
  "holderName": "Chad Jackson",
  "holderType": "individual",
  "accountNumber": "123412341234",
  "bankAccountType": "checking",
  "routingNumber": "123456789"
};
moov.accounts.bankAccounts.link({accountID, bankAccount});

Initiate a transfer

Get the payment method

A payment method specifies the way a Moov account will be moving money. There are a number of different methods for transferring money with Moov — for example, you can transfer money from the Moov wallet. Or, you might want to pull funds from another account through ACH debit. Before making a transfer, you will need to get a payment method.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
const source = {
    accountID: "YOUR_ACCOUNT_ID",
};
const destination = {
    accountID: "Whole_Body_fitness_LLC_ACCOUNT_ID",
};
const amount = {
    currency: "USD",
    value: 100 // equal to $1.00
};
moov.transfers.getOptions({accountID, source, destination, amount});

Make the transfer

To initiate a transfer from your account, you’ll need to pass the following information to Moov:

  • Account information for the entity sending funds, also known as the “source”
    • By default, you have $10 in your Moov wallet you can use for your test transfer. If you’re using those funds for test transfer, the Moov wallet would be the source.
  • Account information for the entity receiving funds, also known as the “destination”
  • $ Amount
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
const transfer = {
  source: {
    paymentMethodID: "ec7e1848-dc80-4ab0-8827-dd7fc0737b43" // Get id from .getOptions method above
  },
  destination: {
    paymentMethodID: "ec7e1848-dc80-4ab0-8827-dd7fc0737b43" // Get id from .getOptions method above
  },
  amount: {
    currency: "USD",
    value: 100 // equal to $1.00
  },
  description: "Pay Instructor for May 15 Class"
};
moov.transfers.create({transfer});

What’s next

Once you’ve gotten set up, you can continue to make transfers or accept payments. You can also customize your account settings, add team members, and manage roles and permissions in the Moov dashboard. Feel free to explore our API reference to see example requests/responses or get more context on a certain endpoint.