Setting Up a Bitnob Account
Building on Bitnob starts with creating and configuring your developer account. Follow the steps below to be ready to test in our Sandbox and eventually go live in Production.
Sign Up for Bitnob
Create Your Account
Visit Bitnob.com and click Sign Up.
Provide basic info (email, password) and confirm your email address if prompted.
Log In to Your Dashboard
Once you confirm your email, sign in at dashboard.bitnob.com.
The dashboard is your control center for generating API keys, managing wallets, and tracking usage.
Complete Basic Profile Setup
Profile Details
Fill in any requested information in the dashboard (company name, contact details, etc.).
KYC/Compliance (Optional at Early Stage)
For initial sandbox testing, you can often proceed without full KYC.
To access higher transaction limits or production-level features, complete any required verification steps (ID documents, business info).
Sandbox vs. Production Environments
Bitnob offers two main environments:
Sandbox:
URL: https://sandboxapi.bitnob.co
Used for testing and development; no real funds are moved.
Production:
URL: https://api.bitnob.co
Live environment for real transactions—only move here once you’re confident in your integration.
Generate API Keys
Store Your Credentials Securely
In your Bitnob dashboard, locate Developer or API Keys.
Create New Keys
Generate a sandbox key for testing and a production key for real transactions.
Store Your Credentials Securely
Use environment variables (e.g., .env files) or a secret manager—never commit keys to public repos.
#Example .env
BITNOB_SANDBOX_API_KEY=sk_sandbox********
BITNOB_PRODUCTION_API_KEY=sk_live********
Verify Your Setup
A quick call to the /v1/me endpoint confirms you’ve set up your account and keys correctly. Here’s an example using a sandbox API key:
Field Explanations
| FIELD | DEFINITION |
|---|---|
| status | Confirms whether the request was handled successfully or encountered an error. |
| data.account.id | Unique identifier for your account. |
| data.account.displayName | A friendly name (or label) for the account. |
| data.account.type | Indicates the environment or status (sandbox vs. production). |
| data.account.plan | Shows the current subscription or usage tier. |
| createdAt | Timestamp of when the account was originally created. |
| updatedAt | Timestamp of the account’s most recent update. |
With your account verified, you’re ready to explore additional endpoints, fund wallets, and begin processing transactions in sandbox—all before going live on production.
Next Steps
Explore the Quickstart: Learn how to create wallets, send test transactions, and handle responses.
Review Core Concepts: Get a broader view of how Bitnob’s rails, wallets, and services connect.
Check Tutorials: See real-world use cases—like airtime payments and Lightning transactions—before diving deeper into the full API Reference.
That's It!
With your Bitnob account created and your API key verified in the sandbox environment, you’re set to begin integrating. This short onboarding flow ensures you can move on to more advanced features without confusion about login, environment selection, or how to secure your credentials.
