Swipelux

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":

POST /v1/customers
{
  "type": "business",
  "legalName": "Acme Corporation",
  "website": "https://acme.com"
}

Response Example

{
  "id": "biz_abc123def456",
  "status": "pending_verification",
  "legalName": "Acme Corporation",
  "website": "https://acme.com"
}

Required vs Optional Fields

FieldRequiredDescription
typeYesMust be "business"
legalNameYesOfficial registered business name
websiteYesCompany website URL
emailNoBusiness contact email
jurisdictionNoCountry of registration (e.g., "US", "UK")

Next Steps

After creating a business customer:

  1. Complete KYB Verification - Submit required business documents
  2. Add Business Details - Provide additional company information
  3. Register UBOs - Ultimate beneficial owners
  4. Add Wallets - Create blockchain wallets for the business
  5. 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

FeatureIndividualBusiness
Identifier Prefixcus_biz_
CreationInstant ({})Requires legal name + website
VerificationOptional KYCRequired KYB
Compliance DocsID, selfieCorporate docs, UBOs
Initial Statusapprovedpending_verification