By including your secret key in the Authorization header of each request you send, you can authenticate your API calls and also manage API keys from the dashboard.
Generally, we provide both public and secret keys.
Public keys are meant to be used from your front end when integrating using Blacbox online and in our Mobile SDKs only. By design, public keys cannot modify any part of your account besides initiating transactions for you.
The secret keys, however, are to be kept secret. If for any reason you believe your secret key has been compromised or you wish to reset them, you can do so from the dashboard.
Secure your secret key
Do not commit your secret keys to GIT, or use them in client-side code.
Authorization headers should be in the following format: Authorization: Bearer SECRET_KEY
Sample Authorization Header
Authorization: Bearer sk_test_shdjkhdj827391nV4Lid
API requests made without authentication will fail with the status code 401:
Unauthorized. All API requests must be made over HTTPS.
Secure your requests
Do not set VERIFY_PEER to FALSE. Ensure your server verifies the SSL connection to Blacbox