Customers

Customer Management

Customers are the foundation of the Swipelux platform. Each customer can hold multiple blockchain wallets and process transfers between fiat and cryptocurrency.

All customers are created via the same unified endpoint: POST /v1/customers

Unified API: Both individual and business customers are created using POST /v1/customers. Use the optional type parameter to specify customer type (defaults to "individual").

Customer Types

Individual Customers

Personal accounts for consumer-facing applications

Business Customers

Corporate accounts with full KYB compliance

Comparison

Feature	Individual	Business
Best For	Consumer apps, retail users	B2B services, corporate clients
Identifier	`cus_xxx`	`biz_xxx`
Creation	`POST /v1/customers` (default)	`POST /v1/customers` with `type: "business"`
Verification	Optional KYC	Required KYB
Compliance	Personal ID docs	Corporate docs + UBOs
Setup Time	Seconds	Minutes to hours

Common Operations

Both customer types support the same core operations:

Wallet Management: Create and manage blockchain wallets
Pay-ins: Accept crypto or fiat deposits
Transfers: Process transfers between wallets and external addresses
Balance Tracking: Monitor balances across all wallets
Webhooks: Receive real-time event notifications

Getting Started

Create an Individual Customer (default):

curl https://wallet.swipelux.com/v1/customers \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_SECRET_API_KEY' \
  --data '{}'

Response:

{
  "id": "cus_cK69MttD5nAUAbud1B",
  "status": "approved"
}

Create a Business Customer:

curl https://wallet.swipelux.com/v1/customers \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key': YOUR_SECRET_API_KEY' \
  --data '{
    "type": "business",
    "legalName": "Acme Corporation",
    "website": "https://acme.com"
  }'