telnesstech

Customers

Manage customer entities and billing relationships

A customer is a billable entity: one person, or one organization. The customer owns the subscriptions and pays for them. Billing and service management in the API are built around this entity.

Customer entity

A customer in the API represents:

  • Billable entity: Individual person or organization responsible for payments
  • Service owner: Entity that owns telecommunications subscriptions and licenses
  • Billing configuration: Payment methods, billing cycles, and financial preferences
  • Contact information: Communication details for service notifications and support

Key capabilities

Customer lifecycle

Create a customer, update it, and hold its profile and its billing configuration.

User management

Add or remove users from customer accounts to manage access permissions and service administration.

Billing configuration

Configure billing methods, payment preferences, and financial settings per customer.

Service ownership

Track all subscriptions, licenses, and services owned by each customer entity.

Common use cases

Customer onboarding

Create new customer accounts with required billing and contact information during signup flows.

Account management

Update customer profiles, billing preferences, and contact details through self-service portals.

Multi-user access

Associate multiple users with business customers for shared service management and administration.

Billing administration

Configure billing methods, payment schedules, and financial settings for automated revenue collection.

Customer entities are closely integrated with other API resources:

  • Users: Platform access and permissions for customer account management
  • Subscriptions: Telecommunications services owned by the customer
  • Orders: Purchase requests and service provisioning for the customer
  • Payments: Financial transactions and billing for customer services
  • Billing settings: Configure billing methods, preferences, and payment automation per customer
  • Licenses: Software licenses and digital services owned by the customer

Next steps