Overview

A Customer represents an individual or business entity that can access and use the system. The Customers API enables managing:

  • Customer profiles and settings
  • Team members and permissions
  • KYC/KYB processes
  • Documents and verifications

Core Concepts

Customer Types

  • individual: Personal accounts
  • company: Company accounts with team management

Customer States

  • KYB: Initial registration and verification
  • SIGN: Document signing phase
  • REVIEW: Compliance review
  • ACTIVE: Fully operational
  • SUSPENDED: Temporarily blocked

Core Properties

FieldTypeDescription
namestringCustomer’s full name
typestringIndividual or business
statusstringCurrent state
countrystringCountry of registration
languagestringPreferred language

Team Roles

  • admin: Full system access and management
  • executive: Executive-level access
  • accountant: Financial operations access
  • employee: Standard access

Team Member States

  • invited: Initial invitation sent
  • accepted: Invitation accepted
  • active: Fully active member
  • removed: Access revoked
  • cancelled: Invitation cancelled

Security Requirements

  • KYC/KYB verification required
  • Team member invitations need approval
  • Document access is role-based
  • Status changes are audited
  • Regular compliance checks

See individual endpoint documentation for detailed request/response formats and examples.