Bank accounts

To transfer money with Moov, you’ll need to link a bank account to your Moov account, then verify that account. You can link a bank account to a Moov account by adding the bank account number and routing number to the account object. We require micro-deposit verification to reduce the risk of fraud or unauthorized activity. You can verify a bank account by initiating micro-deposits, sending two small credit transfers to the bank account you want to confirm. Alternatively, you can link and verify a bank account in one step through an instant account verification token from a third party provider like Plaid.

Add bank account

Link a bank account to an existing Moov account.

To link a bank account, you’ll need to specify the /accounts/{accountID}/bank-accounts.write scope when generating a token.

Parameters

Name Type
accountID UUID string
1
2
3
4
5
6
7
8
9
const accountID = "accountID";
const bankAccount = {
  "holderName": "Jules Jackson",
  "holderType": "individual",
  "accountNumber": "0004321567000",
  "bankAccountType": "checking",
  "routingNumber": "123456789"
};
moov.accounts.bankAccounts.link({accountID, bankAccount});
1
2
const accountID = "accountID";
moov.accounts.bankAccounts.link({plaid: { token: "token"}});
Read more on setting up a Moov managed Plaid integration

List bank accounts

List all the bank accounts associated with a particular Moov account.

To list bank accounts, you’ll need to specify the /accounts/{accountID}/bank-accounts.read scope when generating a token.

Parameters

Name Type
accountID UUID string
1
2
const accountID = "accountID";
moov.accounts.bankAccounts.list({accountID});

Get bank account

Retrieve bank account details (routing number or account type) associated with a specific Moov account.

To retrieve bank account details, you’ll need to specify the /accounts/{accountID}/bank-accounts.read scope when generating a token.

Parameters

Name Type
accountID UUID string
1
2
const accountID = "accountID";
moov.accounts.bankAccounts.get({accountID});

Disable bank account

Discontinue using a specified bank account linked to a Moov account.

To delete a bank account, you’ll need to specify the /accounts/{accountID}/bank-accounts.write scope when generating a token.

Parameters

Name Type
accountID UUID string
1
2
const accountID = "accountID";
moov.accounts.bankAccounts.delete({accountID});

Initiate micro-deposits

Timing: If you request micro-deposits before 4:00 PM ET, they will appear that same day. If you request micro-deposits any time after 4:00 PM ET, they will appear the next banking day.

Micro-deposits help confirm bank account ownership, helping reduce fraud and the risk of unauthorized activity. Use this method to initiate the micro-deposit verification, sending two small credit transfers to the bank account you want to confirm.

To initiate micro-deposits, you’ll need to specify the /accounts/{accountID}/bank-accounts.write scope when generating a token.

Parameters

Name Type
accountID UUID string
bankAccountID UUID string
1
2
3
const accountID = "accountID";
const bankAccountID = bankAccountID;
moov.accounts.bankAccounts.startMicroDepositVerification({accountID, bankAccountID});

Complete micro-deposits

Complete the micro-deposit validation process by passing the amounts of the two transfers.

To complete micro-deposits, you’ll need to specify the /accounts/{accountID}/bank-accounts.write scope when generating a token.

Parameters

Name Type
accountID UUID string
bankAccountID UUID string
amounts number[]
1
2
3
4
const accountID = "accountID";
const bankAccountID = "bankAccountID";
const amounts = [12, 45];
moov.accounts.bankAccounts.completeMicroDepositVerification({accountID, bankAccountID, amounts});

Articles in this section
Summary Beta