Athenian Store Credits & Rewards
product details.
Athenian Store Credits & Rewards unifies points, store credit, checkout redemption, admin controls, and audit-ready customer ledgers in WooCommerce. It helps teams reward customers, issue credits, control redemption, and preserve a clear history of loyalty value across the platform while keeping data, permissions, and automation aligned with the broader Athenian Platform Ecosystem.
Athenian Store Credits & Customer Rewards is a WooCommerce-native loyalty and stored-value plugin that combines reward points, store-credit balances, point-to-credit conversion, checkout redemption, customer self-service tools, admin adjustment workflows, and ledger-backed audit history into one coordinated commerce system.
The plugin manages two connected value tracks: reward points, which customers can earn from purchases, reviews, milestones, and custom Athenian actions, and store credit, which can be applied directly to WooCommerce carts and orders. Customers can view balances from My Account, toggle whether available credit should apply to their next order, and convert points into spendable account credit using a configurable conversion ratio.
For merchants, Athenian Store Credits & Customer Rewards provides operational control over outstanding balances, reward settings, manual adjustments, customer profile controls, credit ledgers, points ledgers, and seven-day movement summaries. Store credit is applied at checkout as a negative WooCommerce fee, persisted to order metadata, captured when the order reaches a paid/fulfilled status, and protected against duplicate debits.
For the broader Athenian Platform, the plugin acts as the stored-value and loyalty infrastructure layer. It can support customer retention, account credits, goodwill adjustments, reward programs, stored-value tender tracking, checkout credits, headless account dashboards, analytics, and future integrations with subscriptions, creator programs, marketplace activity, gallery uploads, social sharing, and other rewardable customer behaviors.
Loyalty & Stored Value
Turn Customer Rewards Into Real Checkout-Ready Store Credit
Athenian Store Credits & Customer Rewards gives WooCommerce stores a
unified loyalty layer where customers can earn points, convert points into
spendable credit, and apply account value to future purchases.
| Value Layer | Customer Experience Value |
|---|---|
| Reward Points | Award points for purchases, approved product reviews, first purchases, lifetime spend milestones, manual adjustments, and custom actions. |
| Store Credit | Maintain a monetary customer credit balance that can be applied directly to WooCommerce cart and checkout totals. |
| Point Conversion | Let customers convert points into store credit using a configurable points-to-credit ratio. |
| Customer Self-Service | Add a WooCommerce My Account Credits endpoint where customers can view balances, enable credit usage, and convert points. |
- Stores customer credit balances in
_ascr_credit_balance. - Stores reward point balances in
_ascr_points_balance. - Uses configurable settings for points per currency unit and points-to-credit conversion.
- Supports external reward events through
ascr/reward_actionand theascr/actions_registryfilter.
Checkout Credits
Apply Store Credit During WooCommerce Cart and Checkout Calculations
The plugin connects customer credit balances to the WooCommerce transaction
lifecycle by applying credit as a capped negative fee, persisting applied
value to the order, and capturing the balance when the order is paid or fulfilled.
Apply available credit as a non-taxable negative WooCommerce fee
Cap credit usage to the customer balance and current cart total
Debit credit once and prevent duplicate captures with order metadata
| Checkout Layer | How It Helps |
|---|---|
| Session Toggle | Stores whether the logged-in customer wants available credit applied to the next order. |
| Negative Fee | Applies store credit during woocommerce_cart_calculate_fees as a negative fee labeled Store Credit. |
| Order Metadata | Persists applied credit amount and shared stored-value tender data when the WooCommerce order is created. |
| Capture Guard | Uses _ascr_credit_captured to prevent the same store credit from being deducted more than once. |
- Stores applied credit on orders with
_ascr_credit_applied_amount. - Writes shared tender data into
_ath_stored_value_tendersfor future gift card, credit, and account-balance integrations. - Captures credit on
woocommerce_order_status_processingandwoocommerce_order_status_completed. - Restricts credit application to logged-in users and clears session flags after capture.
Ledger & Operations
Give Merchants Audit-Ready Loyalty, Credit, and Balance Management Tools
Athenian Store Credits & Customer Rewards provides dedicated credit and
points ledger tables, admin dashboards, manual adjustment workflows, user
profile controls, settings, and optional WPGraphQL fields for platform use.
| Operations Layer | Operational Purpose |
|---|---|
| Admin Overview | Review outstanding credit, non-zero balances, total points, user counts, and recent seven-day movement summaries. |
| Manual Adjustments | Adjust store credit or reward points by email or user ID with optional notes for support and goodwill workflows. |
| Ledger Tables | Track credit and point movements in dedicated custom tables with user, amount, reason/action, metadata, and timestamp context. |
| GraphQL Fields | Expose balances and stored-value tender data to headless storefronts, account dashboards, reporting tools, and mobile apps when WPGraphQL is active. |
Stored value that behaves like part of the platform:
points, credits, checkout redemption, order tender data, manual support
adjustments, and ledger history stay connected instead of being scattered
across coupons, notes, and one-off customer records.
- Creates credit ledger table
wp_ascr_credit_ledgerand points ledger tablewp_ascr_points_ledger. - Adds admin management under WooCommerce > Credits & Rewards.
- Registers optional WPGraphQL fields such as
User.storeCreditBalanceandOrder.storedValueTenders. - Builds toward REST endpoints, customer ledger history, refund/reversal handling, expiration rules, reward emails, analytics, and Athenian Data Intelligence reporting.