Overview
Accounts in Superbank represent wallets that hold stablecoins. Understanding account types is essential for using the Liquidity Settlement product.
Account Types
Prefunded Accounts
Prefunded accounts are your organization’s wallets within Superbank. These are the source accounts for Liquidity Settlement payments.
{
"id": "acc_prefund_abc123",
"type": "PREFUNDED",
"chain": "SOLANA",
"currency_code": "USDC",
"balance": 10000.00,
"wallet_address": "SuperBankPrefund7xKXtg2CW87d97TXJSDpbD5jBkheTqA",
"status": "ACTIVE"
}
| Field | Description |
|---|
id | Unique account identifier |
type | Account type (PREFUNDED) |
chain | Blockchain network |
currency_code | Currency held |
balance | Current balance |
wallet_address | On-chain wallet address |
status | Account status |
External Accounts
External accounts are destination wallets belonging to your end users. When you create a payment, you specify the destination wallet address.
{
"id": "acc_ext_def456",
"type": "EXTERNAL",
"chain": "SOLANA",
"wallet_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
"account_holder": {
"type": "INDIVIDUAL",
"first_name": "John",
"last_name": "Doe",
"email": "[email protected]"
}
}
Individual Account Holder
{
"account_holder": {
"type": "INDIVIDUAL",
"first_name": "John",
"last_name": "Doe",
"email": "[email protected]"
}
}
Business Account Holder
{
"account_holder": {
"type": "BUSINESS",
"business_name": "Acme Corporation",
"email": "[email protected]"
}
}
| Field | Type | Required | Description |
|---|
type | string | Yes | INDIVIDUAL or BUSINESS |
first_name | string | Individual only | First name |
last_name | string | Individual only | Last name |
business_name | string | Business only | Company name |
email | string | Yes | Contact email |
Supported Chains
Each prefunded account is chain-specific. You’ll have separate accounts for each blockchain:
| Chain | Currency | Network |
|---|
| Solana | USDC | Mainnet / Devnet |
| Ethereum | USDC | Mainnet / Sepolia |
| Polygon | USDC | Mainnet / Amoy |
| Base | USDC | Mainnet / Sepolia |
| Tron | USDC | Mainnet / Shasta |
Funding Your Account
To add funds to your prefunded account:
- Navigate to Dashboard > Accounts
- Select the chain you want to fund
- Send USDC to the displayed wallet address
Only send USDC on the correct network. Funds sent on the wrong network may be lost.
Minimum Funding
| Environment | Minimum Deposit |
|---|
| Sandbox | 0 (test tokens) |
| Test | 0 (test tokens) |
| Production | $100 USDC |
Balance Management
Checking Balances
Monitor your prefunded account balances via the Dashboard or API webhook notifications.
Low Balance Alerts
Set up webhook notifications to alert when balance drops below a threshold:
{
"event": "account.balance.low",
"data": {
"account_id": "acc_prefund_abc123",
"balance": 100.00,
"threshold": 500.00
}
}
Automatic Top-Up
Contact support to set up automatic top-ups from a linked bank account (Production only).
Account Lifecycle
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ PENDING │────▶│ ACTIVE │────▶│ CLOSED │
└─────────────┘ └─────────────┘ └─────────────┘
│ │
│ ▼
│ ┌─────────────┐
└────────────▶│ SUSPENDED │
└─────────────┘
| Status | Description |
|---|
PENDING | Account created, awaiting activation |
ACTIVE | Account ready for transactions |
SUSPENDED | Temporarily disabled (compliance review) |
CLOSED | Account permanently closed |
Next Steps
