Capabilities

Request capabilities for accounts, and learn how they determine the actions an account can perform.

Moov has different data and verification requirements depending on the capability, and whether the account represents an individual, or a business. You’ll request the necessary capabilities for an account, and Moov will perform verification checks (if any), and provide a status of enabledpending, or disabled.

Request capabilities

You can request multiple capabilities upon account creation, or request additional capabilities later. If you request a capability by mistake, you can disable it.

The create an account flow in the Moov Dashboard will bring you through the request capabilities flow. If you would prefer to use the API, you can use the request capabilities endpoint.

After you’ve requested capabilities, certain business types will need to provide Moov with a list of financial owners.

Request capabilities after account creation

The following examples demonstrate how to request all four capabilities after an account has already been created. If you want to request capabilities during account creation, see the create accounts guide.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
curl -X POST "https://api.moov.io/accounts/{accountID}/capabilities" \
  -H "Authorization: Bearer {token}" \
  --data-raw '{
    "capabilities": [
      "transfers", 
      "send-funds", 
      "collect-funds", 
      "wallet"
    ]
  }'\
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
const moov = new Moov(credentialsObject);

const accountID = "accountID";
const capabilities = [
  "transfers", 
  "send-funds", 
  "collect-funds", 
  "wallet"
];

const response = await moov.capabilities.requestCapabilities(accountID, capabilities);
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
const moov = Moov(token);

const accountID = "accountID";
const capabilities = [
  "transfers", 
  "send-funds", 
  "collect-funds", 
  "wallet"
];

moov.accounts.capabilities.request({accountID, capabilities});

Transfers

With the transfers capability, you authorize debit transfers (receiving payments or being debited) to your account. The transfers capability will automatically be requested and enabled as soon as each Moov account is created.

Wallet

A Moov wallet allows an account to store funds within the Moov platform. The wallet capability is automatically requested when send-funds or collect-funds is enabled. It can also be requested on its own.

Send funds

The send-funds capability allows an account to send funds to another account.

Collect funds

The collect-funds capability is only available for business accounts.

An account is able to collect or pull a payment from another account. If a transfer source uses the card-payment or ach-debit-collect payment method, the transfer destination must have this capability enabled.

Card issuing

Card issuing is currently in a closed beta — ask our team for more information.

The card-issuing capability allows a platform to issue a virtual, single-use card to a customer, and lets them use their wallet to fund that card. See the issue cards guide for more information.

Capability requirements

Use the buttons below to choose either business or individual to see requirements for each capability. Moov may request additional documents for businesses, representatives, or individuals to complete the verification process and enable capabilities. Document requirements will be communicated in the Dashboard and through the capabilities GET endpoint.

Account type:
Requirement Transfer Wallet Send funds Collect funds Card issuing (beta)
Legal business name
Website or description
Accept Terms of Service
KYC verification
Business type
EIN (SSN can be used for a sole proprietor)
Address
Phone
Business representative
Legal name
Address
Phone or email
Date of birth
Full SSN
isController Job title
isOwner %
ownersProvided1
Underwriting
Industry MCC code
Average transaction size
Average monthly transaction volume
Max transaction size
Business description
Past processing statements
1. ownersProvided is only required if the business type is a private corporation, a partnership, or an LLC.
Requirement Transfer Wallet Send funds
Legal name
Phone or email
Accept Terms of Service
KYC verification
Address
Date of birth
Full SSN

Financial ownership

Moov is required to certify all beneficial owners before an account can be verified. To create owners, use the Dashboard, or use the representatives POST endpoint.

If you create owners through the API, for each owner, set isOwner to true, and provide the ownershipPercentage.

If the businessType is set to privateCorporation, llc, or partnership, you’ll also need to set ownersProvided to true using the accounts PATCH endpoint once all owners have been created.

To view the full instructions and requirements, see the create accounts page. The update accounts page has example requests for ownersProvided.

Outstanding pending capabilities

The Dashboard will display a notice if an account has missing requirements for a requested capability. You can also set up a webhook to listen for events related to capability requests.

If a capability remains in a pending status for 90 days, Moov will unrequest the capability, and remove outstanding requirements for the account. Moov unrequests outstanding pending capabilities to keep accounts and your Dashboard clean.

A pending capability that has been unrequested from an account can be requested again at any time.


Articles in this section
Summary Beta