Internal Wallet-to-Wallet Transfers
In addition to sending stablecoins to external blockchain addresses, Bitnob supports instant internal transfers between wallets on the same Bitnob account. These transfers do not incur gas fees, do not wait for blockchain confirmations, and settle immediately.
This functionality is ideal for:
Moving funds between business units or sub-accounts
Issuing instant credits to customers with Bitnob-linked wallets
Aggregating funds for treasury or payout operations
Key Characteristics
| Property | Internal Transfer | On-Chain Transfer |
|---|---|---|
| Confirmation delay | None | Varies by chain |
| Gas/network fees | None | Yes |
| Status | Instant | Pending → Confirmed |
| Webhooks | Yes | Yes |
| Chain interaction | No | Yes |
Flow Diagram
How It Works
To trigger an internal transfer:
Use the same /wallets/transfer endpoint
Provide the receiving wallet's deposit address or identifier
The system will detect if the destination is internal and bypass the blockchain path
Webhook events are emitted in the same structure as external transfers
If the system detects a valid Bitnob-managed destination wallet, the transfer is netted internally. Otherwise, it routes to the blockchain.
Benefits
Zero latency: Instant crediting, even across multiple customers
Zero gas: Perfect for high-frequency micropayments or loyalty rewards
Unified handling: Same request structure, same webhook schema
Best Practices
Use internal transfers where possible to reduce cost and improve UX
You can maintain a registry of Bitnob-issued addresses to detect eligible internal targets
For treasury management, aggregate user funds via internal transfers before settling out via batch on-chain payouts
