Authentication
Every Moov API request requires a valid OAuth token. Our authentication flow follows the OAuth 2.0 standard. When making requests from the browser, you’ll also need to request scope enums when generating a token. If a scope enum is required, it will be listed with the example.
GenerateToken
Generates an OAuth token required by Moov API requests. For more on our authentication protocol, read our quick start guide.
|
|
Parameters
Name | Type | Description |
---|---|---|
scopes | Array.<SCOPES> | One or more permissions to request |
accountID | string |
Account on which to request permissions, default is your account ID |
Returns
Promise.<Token>
You only need call this function when generating tokens for Moov.js and Moov Drops. The other functions in this library generate tokens for you automatically.
Examples
|
|
Ping
Pings the Moov servers to check for connectivity. Read more about /ping.
|
|
Examples
|
|
Types
Token
OAuth2 token returned by Moov.generateToken()
. Use Token.token
in Moov.js
and client-side code to make calls to the Moov API.
Properties
Property | Type | Description |
---|---|---|
token | string |
String token required by Moov API requests |
expiresOn | Date |
Date and time when the token expires |
refreshToken | string |
String used to refresh this token |
Enums
SCOPES
For client-side integration, you’ll need to request scopes when generating an OAuth token. See available scopes below:
Value | Description |
---|---|
ACCOUNTS_CREATE | Allows a new Moov account to be created |
ACCOUNTS_READ | List connected accounts – see also PROFILE_READ |
BANK_ACCOUNTS_READ | Access to view a linked bank account to a Moov account |
BANK_ACCOUNTS_WRITE | Access to add a linked bank account to a Moov account |
CARDS_READ | Access to view a linked card on a Moov account |
CARDS_WRITE | Access add a linked card to a Moov account |
CAPABILITIES_READ | Access to view capabilities, determining what actions the account can do |
CAPABILITIES_WRITE | Access to request capabilities, determining what actions the account can do |
DOCUMENTS_READ | Access to view documents (like I-9s, W-4s) associated with a Moov account |
DOCUMENTS_WRITE | Access to upload documents (like I-9s, W-4s) associated with a Moov account |
PAYMENT_METHODS_READ | Access to view payment methods for the account specified |
PROFILE_ENRICHMENT_READ | Access to view a Moov account’s profile image |
PROFILE_READ | Access to view details associated with a Moov account – see also ACCOUNTS_READ |
PROFILE_WRITE | Access to edit details associated with a Moov account |
REPRESENTATIVE_READ | Access to view details on business representatives for a Moov account |
REPRESENTATIVE_WRITE | Access to add details on business representatives for a Moov account |
TRANSFERS_READ | Access to view transfers |
TRANSFERS_WRITE | Access to move money by creating transfers |
WALLETS_READ | Access to view the balance on an account’s Moov wallet |
FED_READ | Allows a developer to use the institutions lookup service to look up a bank name by routing number |
PING | Ping Moov servers to test for connectivity |