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
| Entity | Related Entities | Relationship Type |
|---|---|---|
| Company | Projects, Users | 1 → Many |
| Project | Company, Users | Many → 1, Many → Many |
| User | Company, Projects | Many → Many |
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.
