Athenian Credits Manager
product details.
Athenian Credits Manager manages credit packs, auditable credit ledgers, usage events, rewards, and payout-connected credit workflows for WooCommerce and Athenian services. It helps teams treat credits as a governed value system for AI generation, rewards, services, purchases, and partner activity while keeping data, permissions, and automation aligned with the broader Athenian Platform Ecosystem.
Credit Pack Manager is a WooCommerce-native credit commerce and ledger system for selling, awarding, consuming, reserving, transferring, and cashing out platform credits. It turns selected WooCommerce products and variations into credit packs, automatically awards credits when qualifying orders reach processing or completed status, reverses credits on refunds or cancellations, and preserves every credit movement in an authoritative custom ledger table.
Unlike simple user-meta balance counters, CPM treats credits as a real transactional unit. Customers can view balances and transaction history from My Account or a shortcode dashboard, while administrators can search ledger records, reconcile balances, grant or deduct credits, manage rewards, support transfers, process cashout workflows, and inspect detailed usage metadata.
The plugin is built for AI-generation tools, prepaid digital services, creator/vendor ecosystems, reward campaigns, paid downloads, usage-based media workflows, and broader Athenian Platform systems where credits need to support real operational flows. Helper functions and REST endpoints allow other plugins to quote usage, charge credits, log failures, reserve balances, release reservations, transfer credits, and bridge cashout requests into OwlPay.
Within the Athenian Platform, Credit Pack Manager fits as the credit economy and ledger backbone for AI tools, Contour Lab exports, media generation, marketplace activity, Swap workflows, OwlPay payouts, Social Users Core scoring, and future platform-wide credit-backed services.
How Athenian Credits Manager fits the Athenian Platform
Platform role: Athenian Credits Manager is a focused capability in the Payments, Credits & Payouts layer. Its primary scope covers Payouts, Ledger & Settlement and Store Credit, Gift Cards & Rewards while remaining composable with the other modules an implementation actually requires.
Connected scope: Athenian Credits Manager is designed to work inside a WordPress and WooCommerce operating environment where storefront, customer, order, identity, payment, fulfillment, automation, and reporting context can remain connected across relevant modules instead of being trapped in isolated add-ons.
From module to operating platform: Athenian Brands organizes the ecosystem in four connected layers: Platform Kernel and Platform Core foundations; focused capability plugins; implementation and integration services; and operating brands such as PrintGhost.ai, Athenian Marketplace, Athenian Academy, and Athenian Unÿa that apply the same patterns to real business workflows.
Credit Commerce
Turn WooCommerce Products Into Purchasable Credit Packs
Credit Pack Manager lets WooCommerce stores sell prepaid credits through
products and variations, automatically award balances after qualifying
orders, reverse credits on refunds or cancellations, and preserve each
purchase event in a structured credit ledger.
| Commerce Layer | Operational Value |
|---|---|
| Credit Pack Products | Marks selected WooCommerce products or variations as credit packs with configured credit amounts. |
| Order-Based Awards | Awards credits when orders reach processing or completed status, using idempotent event keys to avoid duplicate grants. |
| Refund & Cancel Reversals | Records negative ledger entries when qualifying credit-pack purchases are refunded or cancelled. |
| Custom Top-Ups | Supports custom credit quantities and calculated prices through cart and order item metadata where enabled. |
- Uses product and variation metadata such as
_cpm_is_credit_packand_cpm_credit_amount. - Uses order metadata such as
_cpm_credits_processedto prevent duplicate purchase awards. - Supports order item metadata such as
_cpm_custom_credit_amountand_cpm_custom_credit_price. - Discovers credit-pack products through explicit settings or products marked with credit-pack metadata.
Ledger & Visibility
Track Every Credit Movement With Customer and Admin Visibility
CPM stores credit activity in a dedicated ledger table while exposing
balances through customer dashboards, My Account, admin tools, profile
panels, REST endpoints, AJAX actions, and reconciliation workflows.
Record purchases, usage, refunds, adjustments, transfers, cashouts, and failures
Show balances, transaction history, top-ups, and rich usage details
Adjust, reconcile, transfer, cash out, reset, and inspect credit activity
| Operations Surface | How It Helps |
|---|---|
| Custom Ledger Table | Creates cpm_credits as the authoritative transaction history for credit movements and informational events. |
| Customer Dashboard | Adds a My Account credits endpoint and shortcode dashboard for balance, recent transactions, pagination, and detail toggles. |
| Admin Console | Provides tools for settings, ledger filtering, user search, manual adjustments, reconciliation, transfers, cashouts, and cleanup operations. |
| User Profile Panel | Adds balance, recent ledger history, and admin grant/deduct tools to WordPress user profile screens. |
- Supports customer-facing shortcode names such as
'cpm_credit_dashboard'and embedded product surfaces such as'cpm_product_shadow'. - Includes a tier-pricing debug shortcode name,
'cpm_debug_tiers', for development and pricing-rule inspection. - Stores cached balances in user meta such as
_cpm_credit_balanceand reserved credits in_cpm_credit_reserved. - Records rich metadata such as prompts, media URLs, attachments, failure codes, provider/model details, related IDs, order IDs, product IDs, event keys, and notes.
Platform Credit Economy
Power AI Usage, Rewards, Reservations, Transfers, and OwlPay Cashout Workflows
Credit Pack Manager exposes helper functions, REST routes, pricing quotes,
reward hooks, reservation logic, transfer tools, and cashout operations so
other Athenian modules can use credits as a reliable platform currency.
| Platform Layer | Operational Purpose |
|---|---|
| AI Usage Pricing | Quotes credit costs for image generation, chat completions, structured chat, model/quality/size matrices, reference images, and transparent-background surcharges. |
| Rewards | Grants registration or Google/social sign-on bonuses with once-per-user controls and configurable reward event settings. |
| Reservations & Transfers | Allows credits to be reserved, released, transferred between users, or transferred from reserved balances for marketplace-style workflows. |
| Cashout & OwlPay Bridge | Converts eligible credits into cashout requests, calculates fees and net amounts, and can bridge payout payloads into OwlPay when available. |
Ledger-first platform currency:
CPM is strongest when credits are part of an ongoing product experience,
preserving the operational context behind every purchase, usage event,
reward, transfer, reservation, failure, and payout request.
- Provides helper functions such as
cpm_charge_credits(),cpm_grant_credits(),cpm_log_credit_event(),cpm_reserve_credits(),cpm_transfer_credits(),cpm_cashout_credits(), andcpm_quote_ai_usage(). - Registers REST routes such as
/wp-json/cpm/v1/ledger,/wp-json/cpm/v1/cashout,/wp-json/cpm/v1/transfer, and/wp-json/cpm/v1/payouts. - Fires hooks such as
cpm_credit_balance_changed,cpm_credit_transaction_recorded,cpm_credit_reserved,cpm_credit_transfer_completed, andcpm_credit_cashout_requested. - Publishes sanitized credit signals into Athenian Social Users Core scoring and can bridge eligible cashout workflows into OwlPay.
- Builds toward modern buybox surfaces, quick-buy frontend completion, ledger exports, scheduled integrity checks, balance drift alerts, expiration policies, richer reporting, customer transfer/cashout UI, product-page credit widgets, and rate-plan templates for AI products.