Core Objects
Complete reference for all RevKeen objects and their relationships
This section provides detailed documentation for each core object in RevKeen. Understanding these objects and how they relate to each other is essential for building effective billing workflows.
Products & Pricing
Products
Prices
Checkout Links
Discounts
Sales & Billing
Invoices
Invoice Line Items
Orders
Subscriptions
Customers & Activity
Customers
Events
Object Relationships
Products → Prices: A product can have multiple prices (e.g., monthly at $29 and annual at $290).
Prices → Checkout Links: A checkout link references one or more prices to create a purchasable offering.
Checkout → Orders/Subscriptions: Completing checkout creates an Order (one-time) or Subscription (recurring).
Orders/Subscriptions → Invoices: Both generate invoices - orders immediately, subscriptions at each billing period.
Invoices → Payments: Invoices track payment attempts, success, refunds, and disputes.
Everything → Events: All actions generate events for a complete audit trail.
Quick Reference
| Object | Purpose | Key Relationship |
|---|---|---|
| Product | Define what you sell | Has many Prices |
| Price | Define how much and how often | Belongs to Product |
| Checkout Link | Shareable purchase URL | References Prices |
| Customer | Who you bill | Has many Orders, Subscriptions |
| Order | One-time purchase | Generates Invoice |
| Subscription | Recurring billing | Generates Invoices periodically |
| Invoice | Payment request | Has many Line Items |
| Discount | Promotional pricing | Applied to Orders/Subscriptions |
| Event | Audit trail | References all objects |