Get started
Use the Moov Dashboard to create an account. You’ll need to be approved for a production account before you can start moving real money.
Moov uses API keys to generate tokens that authenticate your API requests. If your request does not include a valid token, you will receive an error.
Create a new API key
To create a new API key, navigate to Developers in the Moov Dashboard. Select API keys, where you can view/edit existing keys and create new ones. Test mode and production mode each require their own API keys.
Note: only accounts with admin
and developer
permissions will be able to create and view API keys. For more on permissions, see managing teams.
-
Set a name for the API key. You can name the key however you’d like. This field is customizable so you can remember the purpose of the API key you’re creating.
-
Copy your secret key and save it in a confidential, secure place.
-
Add any domains you will use for testing and production to the domain list.
-
(Optional) After creating the key, you can include a note to remind yourself where the key is stored (for example, “Stored as an environment variable in the payments service”).
Find your API keys
If you need to locate your API key, you can always find it in the Moov Dashboard. However, if your account doesn’t have admin
or developer
permissions, you won’t have access to view or create API keys. If you’re unable to find your API key, you may want to request access from an administrator on your Moov account.
API keys contain a public key and a secret key. The secret key cannot be viewed in Moov after the API key is created, so we recommend immediately storing it in a safe place. If you have lost your secret key, you should delete that API key and create a new one.
Deactivate API keys
If your API key is compromised, delete it from the list of API keys in Moov. This will immediately ensure that the key cannot be used. You can then create a new key.
Explore test mode
While test mode is optional, we strongly suggest you try it out. After you’ve created an account, test mode with test data will be automatically enabled in the Dashboard so you can explore how the platform works. Make sure you’re in test mode by using the account switcher on the top left.
Try out the following:
- Add a bank account
- Initiate verification
- Initiate a transfer
- Initiate a return
Read the test mode documentation.
Switch to production mode
When you’re ready to switch to production mode, use the account switcher located on the top left of the Dashboard. Before you start using production mode, make sure to:
- Have your production API key
- Switch out the account ID anywhere it’s hard coded
- Set up new webhook URLs if you used any in test mode
Read the production mode documentation.