How to Find Your API Keys
Once you are ready to start testing and building with our infrastructure, you need your API keys to authenticate your connection with our servers. We use API keys to identify that you are a legitimate connection.
To get your API keys, go to the Settings page; then, go to the Developer menu and toggle on Access Developer Tools.
- Secret key: They are responsible for authenticating all transactions and API requests sent from your platform. Like the name states, they are meant to be kept secret. If for any reason you believe your secret key has been compromised, you can create a new one from the Developer page.
- Public key: This is meant to be used from your front end when integrating our widget (or any client-side component). Basically, public keys cannot modify any changes to your account except for initiating transactions with you.
Important: Do not use your secret key in client-side code or include it in any part of public code.
Having Issues with Your API Credentials?
Here's what to do when you have issues authenticating your API connection with us.
Make sure you are using the right keys for the right environment.
Test API credentials will not work in Live Mode, and live API credentials will not work in Test Mode. Make sure that you are using the right API credentials.
To access live or test mode of the dashboard, go to the Settings page; then, go to the Developer menu and toggle on Access Developer Tools.
Once you do this, you'll see the live mode button at your screen's top right corner. You can toggle this button to switch to test mode and get your Test API Keys.
To learn more about our environments, read this article: What is the difference between Live Mode and Test Mode?
Make sure the keys are written correctly
A good rule of thumb is to copy and paste the keys instead of typing them manually. However, in the rare case that you decide to type it in manually, make sure you are typing them correctly. API keys are case-sensitive, make sure all of the special characters and letters are written correctly.
You are using the wrong kind of keys
Your Secret Key is used to authenticate your connection to our infrastructure, while your Public Key is used for client-side communication with our infrastructure.
Make sure you are not using your Public Key in place of your Secret Key. To learn more about API credentials, read this article: Getting Started with the Bloc API.