Business Customers
Create and manage business customer accounts with KYB compliance
Business Customers
Purpose: Create business customer accounts for corporate clients with full KYB (Know Your Business) compliance.
Business customers represent corporate entities using your platform. Each business customer has a unique identifier starting with biz_ and can hold multiple blockchain wallets for processing transfers between fiat and cryptocurrency.
Unified API: Business customers are created using the same POST /v1/customers endpoint as individual customers. Simply add "type": "business" to the request body.
When to Use Business Customers
Use business customers for:
- Corporate accounts
- B2B service providers
- Institutional clients
- Companies requiring KYB verification
For personal user accounts, see Individual Customers.
Creation
Business customers are created using POST /v1/customers with type: "business":
Response Example
Required vs Optional Fields
| Field | Required | Description |
|---|---|---|
type | Yes | Must be "business" |
legalName | Yes | Official registered business name |
website | Yes | Company website URL |
email | No | Business contact email |
jurisdiction | No | Country of registration (e.g., "US", "UK") |
Next Steps
After creating a business customer:
- Complete KYB Verification - Submit required business documents
- Add Business Details - Provide additional company information
- Register UBOs - Ultimate beneficial owners
- Add Wallets - Create blockchain wallets for the business
- Create Transfers - Process business transactions
Key Features
- KYB Compliance: Full Know Your Business verification workflow
- Multiple Wallets: Support multiple blockchain networks per business
- Corporate Structure: Track shareholders and beneficial owners
- Verification Status: Monitor compliance status via webhooks
- Risk Assessment: Business activity and source of funds tracking
Differences from Individual Customers
| Feature | Individual | Business |
|---|---|---|
| Identifier Prefix | cus_ | biz_ |
| Creation | Instant ({}) | Requires legal name + website |
| Verification | Optional KYC | Required KYB |
| Compliance Docs | ID, selfie | Corporate docs, UBOs |
| Initial Status | approved | pending_verification |