Skip to main content
Every ZBD project comes with its own programmable Bitcoin Lightning wallet. This isolated wallet gives you complete control over your project’s funds, transactions, and financial operations – all accessible via API.
Core Architecture: 1 Project = 1 Wallet = 1 API Key. This separation ensures clean accounting, isolated risk, and granular control.

​
How Project Wallets Work

Isolated Funds

Each project has its own Bitcoin balance, completely separate from other projects

API Controlled

Every transaction through your API key affects only this wallet

Real-time Updates

Balance changes instantly with Lightning-speed settlements

​
Wallet Architecture

​
Wallet Dashboard

Navigate to your project’s Wallet tab to access comprehensive financial data:
Project Wallet Overview

Project wallet dashboard showing balance and transactions

​
Wallet Management Best Practices

Buffer Recommendation: Keep 1.5x your daily volume
  • Monitor daily burn rate
  • Automate top-ups if possible
  • Plan for traffic spikes
Protect Your Funds
  • Use IP allowlisting for API keys
  • Enable 2FA on your account
  • Regularly audit transactions
  • Set up webhook notifications
When to Use Multiple Projects
  • Different apps/games
  • Staging vs production
  • Regional separation
  • Department budgets
Financial Tracking
  • Export transactions monthly (talk to your Customer Success Manager)
  • Use reference IDs for reconciliation
  • Track by project for clean books
  • Integrate with accounting software

​
Common Wallet Operations

​
Check Balance

const wallet = await zbd.getWallet();
console.log(`Balance: ${wallet.balance} sats`);
console.log(`USD Value: $${wallet.balanceUSD}`);

​
Transfer Between Projects

// Transfer funds between your projects
const result = await zbd.internalTransfer({
  amount: 10000,
  receiverWalletId: 'project_abc123',
  reference: 'Budget reallocation'
});

​
Next Steps

Send First Payment

Make your first Lightning payment

Set Up Webhooks

Monitor transaction updates in real-time
Pro Tip: Use project wallets to isolate financial risk. If one project has issues, your other projects remain unaffected. This is especially important for testing new features or running experiments.