Moov.js makes it easy to capture the information from each of your users to create a Moov account and link their bank accounts.
The following example creates a new Moov account and requests four capabilities for that account.
The account creation method will return the account object. You can use the
account.accountID to request the capabilities required.
You can add a
foreignID or alias to a Moov account to easily track the one-to-one relationship between your users and Moov accounts. If you set the foreign ID, it must be unique.
You can find use the
foreignID query parameter on the List accounts endpoint to find a Moov account.
Metadata is a free-form key-value pair list that you can add to a Moov account. This may be useful for capturing information such as the type of account or segment the Moov account belongs to.
Moov makes it easier for your customers to fill in their details by offering form shortening. Start by collecting an email address and passing it through profile enrichment.
For an individual, publicly available details like their name and portions of their address may be returned. For businesses, the legal business name, website, email, phone, and industry codes may be returned. Use this data to autofill forms and ask your users to confirm it for accuracy.
Platform terms of service agreement
If the account requested a capability that requires acceptance of the Moov terms of service, the account holder must accept Moov’s platform agreement. In your application, you must display a link to the Moov platform terms of service agreement, and have them accept those terms.
Once they’ve accepted the terms of service, you’ll need to update the account via API:
GETthe terms of service token
PATCHthe generated terms of service token to the account
Indicating ownership information is complete
Depending on the
businessType of their Moov account, your customers need to certify that they have provided information for all persons over the ≥ 25% ownership threshold. By setting
ownersProvided = true, you are indicating that all the ownership information provided is accurate and complete. To learn more about verifying businesses, read our business representatives guide.
To update the
ownersProvided field, use the
PATCH account endpoint.
|Moov account businessType||ownersProvided Required|
Depending on the capabilities requested for the Moov account you just set up, you may need to provide additional information about the account in order for Moov to start the automatic verification process.
For more information, read our Identity verification guide.