Documentation Index
Fetch the complete documentation index at: https://docs.bluumfinance.com/llms.txt
Use this file to discover all available pages before exploring further.
The sandbox simulates the full Bluum environment — accounts, trading, funding, and webhooks. This guide covers how to test each part of your integration systematically.
Test scenarios by domain
Account creation
| Scenario | How to test |
|---|
| Successful creation | Submit valid account data → verify ACTIVE status |
| Validation failure | Omit required fields → verify error response |
| Duplicate account | Create two accounts with same email → verify 409 conflict |
KYC verification
| Scenario | How to test |
|---|
| Approval | Upload any valid image → auto-approved in sandbox |
| Rejection | Use test rejection values (see dashboard) |
| Missing document | Attempt operations before KYC → verify error |
Deposits
| Scenario | How to test |
|---|
| ACH success | Create deposit with valid Plaid options → transitions to completed |
| Manual transfer | Create manual deposit → verify bank details in response |
| Insufficient funds | Create withdrawal exceeding balance → verify 422 error |
| Idempotency | Submit same deposit twice with same key → verify no duplicate |
| Idempotency conflict | Submit different body with same key → verify error |
Trading
| Scenario | How to test |
|---|
| Market buy | Place market order during hours → verify filled status |
| Limit order | Place limit below market → remains accepted |
| Fractional buy | Use notional for dollar-based purchase |
| Insufficient funds | Place order exceeding wallet balance |
| Invalid symbol | Use non-existent symbol → verify error |
Webhooks
| Scenario | How to test |
|---|
| Event delivery | Register webhook, place order → verify event received |
| Duplicate delivery | Process same event twice → verify idempotent handling |
| Failure retry | Return 500 from webhook → verify Bluum retries |
Sandbox-specific behaviors
Timing
- Market orders fill instantly (no execution delay)
- ACH deposits complete in seconds (not days)
- KYC documents auto-approve immediately
Data reset
- Sandbox data resets nightly at midnight UTC
- All accounts, orders, and deposits are cleared
- Webhook registrations persist across resets
Plaid sandbox
- Use Plaid sandbox credentials (provided in your dashboard)
- Test bank: “First Platypus Bank” with credentials
user_good / pass_good
Integration test checklist
Run through this checklist before going live:
Automated testing tips
// Use environment variables for easy switching
const config = {
baseUrl: process.env.BLUUM_BASE_URL || 'https://test-service.bluumfinance.com/v1',
apiKey: process.env.BLUUM_API_KEY,
apiSecret: process.env.BLUUM_API_SECRET
};
// Generate unique idempotency keys per test run
const idempotencyKey = `test-${Date.now()}-${Math.random().toString(36).slice(2)}`;
// Clean up: note that sandbox resets nightly, but you may want to
// cancel pending orders and withdrawals between test runs
Next steps
When all tests pass, follow the Going Live checklist to move to production.
