Skip to main content

Entities

The Chargeworx data model is organized around core entities that define how business data, operational configuration, and permissions interact across the platform.

Core entities

Company

Represents a client or business account in Chargeworx.

Project

Defines an operational environment for transactions and processors.

User

Represents an authenticated individual with role-based access.

Transaction and payment entities

Transaction

Core transaction processing and line item models.

Payment

Payment methods, billing agreements, and customer data.

Chargeback and refund

Dispute management and refund processing models.

Processing and validation entities

Processor

Payment gateway configuration and result codes.

Response and validation

AVS and CVV validation response models.

Batch and import

Bulk processing and transaction import models.

System and security entities

Account updater

Automatic credit card update tracking models.

Background process

Asynchronous job execution and scheduling models.

Security and auth

Authentication, authorization, and API access models.

Entity relationship summary

EntityRelated EntitiesRelationship Type
CompanyProjects, Users1 → Many
ProjectCompany, UsersMany → 1, Many → Many
UserCompany, ProjectsMany → Many
Company → Project (1:N)
Project → User (N:M)
User → Company (M:1)

Implementation notes

  • The Company entity provides the authentication and billing scope.
  • Projects act as configurable execution layers.
  • Users are linked via IdentityServer and governed by company-level permissions.