Setting Up a Bitnob Account
Building on Bitnob starts with creating and configuring your developer account. Follow the steps below to test in our Sandbox environment and go live in Production once you’re ready.
Create Your Account
Visit app.bitnob.co and click Sign Up.
Enter a valid email address and a strong password (at least 12 characters, mix of letters, numbers, symbols).
Check your inbox and click the confirmation link. If you don’t see it, look in your spam folder.
Log In to Your Dashboard
After email confirmation, go to Dashboard.
Enter your email and password to sign in.
Familiarize yourself with the main sections: API Keys, Wallets, Transactions, and Usage Reports.

Complete Basic Profile Setup
Add Company and Contact Info
In the Profile section, enter your company name or project name.
Provide a contact phone number and mailing address (used for invoices and notifications).
Optionally upload a logo or avatar to personalize your dashboard view.
KYC and Compliance (Optional for Sandbox)
For sandbox testing, you can skip verification and operate under default limits.
To lift transaction limits and unlock Production, submit your business registration documents, ID proofs, and bank account details under Identity & Compliance.
Verification usually completes within 24–48 hours. You’ll get an email update once approved.
Sandbox vs. Production Environments
Bitnob provides separate endpoints for testing and live operations. Always isolate your code to avoid mixing environments.
Sandbox Environment
Use sandbox keys to test wallet creation, payments, and webhooks without moving real funds.
Data resets periodically; don’t rely on sandbox for long-term records.
Production Environment
Only switch here when you’ve fully tested flows and completed any required KYC.
Monitor live transactions, balances, and error logs in real time.
Generate HMAC Client ID and Secret Key
Secure your integration by generating separate credentials for sandbox and production.
Locate API Keys Section
In the left menu, select Developer > API Keys.
You’ll see existing keys (if any) and the option to create new ones.
Create New Key Pair
Click Create Key. Choose Sandbox or Production from the dropdown.
Give each key a recognizable name (e.g., dev-sandbox-key
, prod-main-key
).
After creation, copy the Client ID and Secret Key immediately; you won’t see the secret again.
Secure Storage
Store credentials in environment variables or a secure vault (e.g., AWS Secrets Manager, HashiCorp Vault).
Never hardcode keys or check them into source control.
Rotate keys regularly and revoke unused ones.
Example .env
File
BITNOB_CLIENT_ID=yourClientId***
BITNOB_SECRET_KEY=yourSecretKey***
Verify Your Setup
A quick call to the /api/v1/wallets endpoint confirms you’ve set up your account and keys correctly. To learn about authenticating your API requests, refer to our Authentication Guide Here’s an example using a sandbox API key:
Next Steps
Explore the Quickstart: Follow our guide to create wallets, send test payments, and handle callbacks.
Review Core Concepts: Understand how Bitnob’s rails, wallets, and events connect across the platform.
Check Tutorials: See real-world use cases—like airtime top-ups and Lightning transactions—before diving into the full API Reference.
That’s It!
With your Bitnob account created and your API credentials verified in sandbox, you’re ready to integrate with confidence. Move on to advanced features and scale your application for production when you’re ready.