Overview
Your Superbank account represents your organization (PSP, neobank, or asset manager). It’s the foundation for all API interactions and contains your:
- API credentials
- Prefunded stablecoin accounts
- Webhook configurations
- Payment history
Getting Started
To get started with Superbank, contact our team at [email protected].
Business verification (KYB) is required for production access.
Verification Status
| Status | Description | Access Level |
|---|
PENDING | Account created, verification in progress | Sandbox only |
APPROVED | Verification complete | Full access |
REJECTED | Verification failed | Contact support |
API Keys
Your account has separate API keys per environment:
| Key Type | Prefix | Environment | Use Case |
|---|
| Sandbox | sk_sandbox_ | Sandbox | Development and testing |
| Production | sk_live_ | Production | Live transactions |
Managing API Keys
From the Dashboard, you can:
- Create new API keys
- Revoke compromised keys
- Rotate keys periodically
Revoking a key is immediate and irreversible. Ensure your application uses the new key before revoking the old one.
Rate Limits
API rate limits are per account:
| Environment | Requests/Minute |
|---|
| Sandbox | 100 |
| Production | 1000 |
429 Too Many Requests response with a Retry-After header.
You can store custom metadata on your account for your reference:
{
"id": "org_abc123",
"name": "Acme Corp",
"email": "[email protected]",
"status": "APPROVED",
"metadata": {
"internal_id": "acme-123",
"tier": "enterprise"
},
"created_at": "2024-01-15T10:30:00Z"
}
Multiple Environments
We recommend using separate processes or environments for:
| Environment | Purpose | API Key |
|---|
| Local Development | Building features | Sandbox |
| Staging | QA testing | Sandbox |
| Production | Live users | Production |
Use environment variables to switch between API keys without code changes.
Next Steps
