Documentation
Admin Docs
-
Admin Docs Overview
These Admin Docs are for store owners, shop managers, support teams, finance teams, and operations teams who run AweCommerce from WordPress admin. The Admin Docs explain how to set up, operate, and troubleshoot the store by clicking through WordPress admin and the storefront. They avoid implementation details and focus on what an operator needs to read more
-
Admin Quick Start
This quick start will help you get the store running from plugin installation to a test purchase. Step 1: Installation And Activation Follow these instructions to install and activate AweCommerce If you see a setup warning, continue to the Launch Guide. Step 2: Create Store Pages 1. Open AweCommerce, then Launch Guide. 2. Review the read more
-
How To Complete The Launch Guide
The Launch Guide is the admin checklist for preparing a store to accept customers. Open The Launch Guide 1. Open WordPress admin. 2. Open AweCommerce. 3. Select Launch Guide. Review Setup Status Look for: Missing store pages. Pages that need repair. Missing gateway credentials. Missing email settings. Missing currency settings. Store Health warnings. Licensing readiness read more
-
How To Configure Store Pages And Navigation
AweCommerce uses WordPress pages for public shopping and customer account experiences. Store Pages The standard pages are: Shop. Cart. Checkout. Account. Order Confirmation. Payment Failed. Payment Recovery. What Each Page Does Shop lets buyers browse products. Cart lets buyers review selected items. Checkout collects customer details, agreements, and payment. Account lets customers manage orders, subscriptions, read more
-
How To Configure Store Settings
Store settings control how AweCommerce behaves for buyers, customers, and admins. Open Settings 1. Open WordPress admin. 2. Open AweCommerce. 3. Select Settings. 4. Work through each tab. Configure Email Settings 1. Open the Email tab. 2. Set sender name. 3. Set sender email. 4. Set reply-to email. 5. Add support email. 6. Add logo read more
-
How To Configure Payment Gateways
Payment gateways let AweCommerce collect money or record offline payment instructions. Gateway Overview Supported payment options are: Stripe. PayPal. Flutterwave. Adyen. PayMongo. 2C2P Antom. PayU Latam. Store Gateway. Stripe and PayPal support recurring subscription products. The other payment options are for one-time checkout in the current store. General Setup Steps 1. Open AweCommerce, then Settings. read more
-
How To Create And Manage Products
Products are the items buyers can view and purchase. Product Types AweCommerce supports these product types: Virtual product. Downloadable product. Service. Membership. Software. A product can use more than one type. For example, a software product is usually also downloadable. Create A Basic Product 1. Open AweCommerce, then Products. 2. Select Add New. 3. Enter read more
-
How To Configure Prices Trials And Purchase Options
Prices are the purchase options buyers choose. Price Types A product can have: One-time price. Recurring price. Monthly price. Annual price. Trial price. Setup fee plus recurring price. Multiple plan choices. Add A One-Time Price 1. Edit product. 2. Open Payment Options. 3. Add a price. 4. Name the price. 5. Enter amount. 6. Confirm read more
-
How To Configure Taxes And Coupons
Configure Tax Rates 1. Open AweCommerce, then Taxes. 2. Add a tax rate. 3. Choose country. 4. Choose state or region if the rate is regional. 5. Enter percentage. 6. Choose whether tax is added on top of price or already included in price. 7. Save. 8. Run a checkout test using a buyer address read more
-
How To Sell Downloads
Downloadable products give buyers access to files after purchase. Create A Downloadable Product 1. Open AweCommerce, then Products. 2. Add or edit product. 3. Select Downloadable product type. 4. Add product title, description, and images. 5. Add a price. 6. Open Downloads. 7. Add file name. 8. Add file location. 9. Set download limit if read more
-
How To Create Memberships And Protected Content
Membership products grant access to protected content or member benefits. Create A Membership Product 1. Open AweCommerce, then Products. 2. Add or edit product. 3. Select Membership product type. 4. Add product title, description, and images. 5. Configure membership settings. 6. Add a one-time or recurring price. 7. Save product. 8. Run a test purchase. read more
-
How To Sell Licensed Software
AweCommerce can sell licensed WordPress plugins, WordPress themes, and bundles. Software Product Types Choose one: WordPress plugin. WordPress theme. WordPress bundle. Create A Licensed Plugin Product 1. Prepare a clean product package. 2. Open AweCommerce, then Products. 3. Add or edit product. 4. Select Software and Downloadable product types. 5. Choose WordPress plugin. 6. Enter read more
-
How To Publish Software Updates
Software updates let licensed customers update a purchased plugin or theme from their WordPress admin. Before Publishing Confirm: The package is clean. The version shown inside the package matches the version you will enter. The package belongs to the correct product. The package is not personalized for one customer. No customer details are inside the read more
-
How To Manage Orders Refunds And Invoices
View Orders 1. Open AweCommerce, then Orders. 2. Search or filter orders. 3. Open an order. 4. Review customer details. 5. Review items. 6. Review payment status. 7. Review totals. 8. Review gateway details. 9. Review related invoice. 10. Review linked split orders if present. Order Statuses Order statuses shown to admins include: Pending. Processing. read more
-
How To Manage Customers
Customer records connect purchases, subscriptions, downloads, licenses, invoices, notes, addresses, and WordPress accounts. View Customers 1. Open AweCommerce, then Customers. 2. Search by name or email. 3. Open the customer record. 4. Review profile. 5. Review linked WordPress account. 6. Review addresses. 7. Review notes. 8. Review orders. 9. Review subscriptions. 10. Review downloads. 11. read more
-
How To Manage Subscriptions And Dunning
Subscriptions represent recurring customer relationships. Subscription Statuses Subscriptions can be: Pending. Trialing. Active. Past due. Paused. Cancelled. Expired. View Subscriptions 1. Open AweCommerce, then Subscriptions. 2. Search or filter subscriptions. 3. Open a subscription. 4. Review customer. 5. Review plan. 6. Review current period. 7. Review next payment date. 8. Review gateway details. 9. Review read more
-
How To Manage Licenses Activations And Domains
Licenses control customer access to software products, updates, downloads, and support. License Statuses Licenses can be: Active. Expired. Suspended. Disabled. Revoked. Refunded. Chargeback. Over limit. View Licenses 1. Open AweCommerce, then Licenses. 2. Search by customer, order, product, or key. 3. Open license. 4. Review status. 5. Review customer. 6. Review covered products. 7. Review read more
-
How To Configure Emails And Notifications
Emails keep buyers informed about orders, refunds, subscriptions, invoices, dunning, and licenses. Email Templates AweCommerce includes templates for: Paid order receipt. Refund receipt. Payment failed. Software license keys. Subscription welcome. Subscription renewed. Subscription cancelled. Trial ending. Invoice issued. First dunning attempt. Final dunning notice. Dunning recovered. Configure Sender 1. Open AweCommerce, then Settings. 2. Open read more
-
How To Use Reports Store Health And Operations
Dashboard Use the Dashboard for daily store status. Review: Recent revenue. Failed payments. Background tasks. Webhook health. Gateway status. Setup status. Pending renewals. Notifications. Reports Reports can show: Net revenue. Gross revenue. Paid orders. Checkout count. Average order value. Refunds. Refund rate. Failed payments. Failed payment rate. Recurring revenue. Churn. Tax collected. Coupon usage. Product read more
-
Admin Troubleshooting
Checkout Fails Check: Product is published. Price is active. Gateway is enabled. Gateway credentials are valid. Store is in the intended mode. Buyer country and currency are supported. Coupon is valid. Required agreements are shown. Webhook settings are correct. Coupon Fails Check: Coupon is active. Coupon is not expired. Coupon applies to the selected product. read more
End User Docs
-
Loyalty Program
The Loyalty Program allows store owners to award points for eligible paid orders and let customers redeem available points as store credit during checkout. How to set it up? Recommended setup practices: Admin operations: Refund and reversal behavior: read more
-
Wise bank transfer
Wise bank transfer support is available for one-time checkout flows. It provides pending checkout instructions, verified/simulated incoming-transfer matching, a manual review workflow for ambiguous transfers, Store Health visibility, and redaction safeguards. Wise bank transfer lets a store offer a manual bank-transfer checkout option for one-time purchases. The customer receives exact transfer instructions on the order read more
-
End User Docs Overview
These End User Docs are for buyers and customers who shop, check out, manage accounts, manage subscriptions, download files, view invoices, and activate licensed products. The exact labels on your store may vary, but the flows are the same. What Customers Can Do Customers can: Browse products. Compare product plans. Add products to cart. Use read more
-
How To Shop And Choose A Product
Browse Products 1. Open the store. 2. Go to the Shop page. 3. Browse products. 4. Use search or category filters if available. 5. Open a product to learn more. Compare Plans Some products have multiple purchase options. Common options include: Monthly plan. Annual plan. Lifetime plan. Personal plan. Agency plan. Trial plan. Review: Price. read more
-
How To Use Cart Checkout And Coupons
Add To Cart 1. Open a product or pricing table. 2. Choose the plan or price. 3. Select the purchase button. 4. Open Cart. 5. Review the selected items. Update Cart Depending on the store, you may be able to: Remove an item. Change quantity. Continue shopping. Go to checkout. Apply Coupon 1. Open Cart read more
-
How To Read Order Confirmation And Receipts
Order Confirmation Page After successful checkout, the store may show an Order Confirmation page. It can include: Order number. Order status. Purchased products. Total paid. Next steps. Account link. Download or license information. Email Receipt You may receive an email receipt after payment. The receipt can include: Order number. Purchased products. Amount paid. Billing details. read more
-
How To Use The Account Portal
The Account page is where customers manage purchases. Sign In 1. Open Account. 2. Sign in with the account linked to your purchase. 3. If you do not have a password, use the store’s password reset flow. 4. After signing in, return to Account. Account Sections You may see: Overview. Profile. Billing. Subscriptions. Orders. Downloads. read more
-
How To Manage Profile Addresses And Billing
Update Profile 1. Open Account. 2. Open Profile. 3. Edit first name or last name. 4. Save. Change Email 1. Open Account. 2. Open Profile. 3. Enter new email if the store allows it. 4. Save. 5. Confirm the change if the store sends a confirmation message. If an email change is pending and you read more
-
How To Manage Subscriptions
View Subscriptions 1. Open Account. 2. Open Subscriptions. 3. Review each subscription. You may see: Status. Plan name. Current billing period. Next payment date. Trial status. Payment method. Related invoices. Cancel Subscription If the store allows customer cancellation: 1. Open Account. 2. Open Subscriptions. 3. Choose subscription. 4. Select Cancel. 5. Choose immediate cancellation or read more
-
How To Recover A Failed Payment
If a subscription renewal payment fails, the store may send a payment recovery email. Use The Recovery Email 1. Open the recovery email. 2. Select the recovery link. 3. Sign in if requested. 4. Enter a new payment method. 5. Save. 6. Wait for confirmation. 7. Open Account, then Subscriptions. 8. Confirm the subscription returns read more
-
How To Download Files And Software
View Downloads 1. Sign in. 2. Open Account. 3. Open Downloads. 4. Find the product. 5. Select Download. Download Access Download access may depend on: Paid order. Active subscription. Membership access. License coverage. Access duration. Download limits. Software Downloads Software products may download as personalized packages. Do not share personalized software packages with other people. read more
-
How To Activate Licensed Software
This article is for customers who bought a licensed WordPress plugin or theme. Find Your License Key You can usually find the license key: In your license email. In Account, under Licenses. In your purchase receipt if the store includes it there. Keep the key private. Install A Purchased Plugin 1. Download the plugin package read more
-
How To Manage License Keys And Domains
View Licenses 1. Sign in. 2. Open Account. 3. Open Licenses. 4. Select a license. You may see: License status. Product name. License key. Covered products. Activation limit. Activated domains. Download options. Reveal Key If the key is hidden and reveal is allowed: 1. Open Account. 2. Open Licenses. 3. Select license. 4. Select Reveal read more
-
How To View Invoices
Open Invoices 1. Sign in. 2. Open Account. 3. Open Invoices. 4. Choose invoice. Invoice Details Invoices can include: Invoice number. Status. Issue date. Paid date. Customer details. Seller details. Billing address. Products or services. Discount. Tax. Total. Download Invoice 1. Open invoice. 2. Select Download. 3. Save the file. Invoice Not Found If an read more
-
End User Troubleshooting
Cannot Sign In Try: 1. Use the email from checkout. 2. Reset password. 3. Check for account invitation email. 4. Contact support. Order Missing Check: Correct account. Correct email. Payment completed. Receipt email. Contact support with order email and payment date. Download Missing Check: Correct account. Paid order. Active subscription if required. Product access period. read more
Developer Docs
-
Docs Overview
These Developer Docs cover architecture, extension points, REST APIs, WP-CLI, hooks, filters, data tables, gateway adapters, software licensing, client SDK integration, package delivery, queues, tests, and integration recipes. All technical examples live in the Developer Docs so Admin and End User Docs stay operator-focused. Current Source Snapshot Product: awecommerce Plugin version: 1.0.0 Documentation version: 4.0 read more
-
Bootstrap And Lifecycle
Main Plugin Constants The main plugin file defines AWECOMMERCE_VERSION: Activation And Deactivation Activation and deactivation are handled through the installer: Activation responsibilities include: Running migrations. Creating tables. Adding capabilities. Creating or updating awc_shop_manager. Scheduling cron events. Deactivation responsibilities include: Unscheduling queue cron events. Leaving commerce data intact. Lifecycle Hooks Use lifecycle hooks for integrations: Plugin read more
-
Data Model
Table Inventory AweCommerce stores commerce records in dedicated tables: Product Tables awc_products mirrors commerce product state from awc_product posts. awc_prices stores purchasable price options. awc_price_tiers supports tiered price rows. Customer Tables awc_customers stores customer identity and linked WordPress user. awc_addresses stores billing and shipping addresses. awc_customer_notes stores support notes. awc_payment_methods stores gateway payment method metadata. read more
-
Products Prices And Content
Product Post Type AweCommerce registers a public product post type: The post type supports: Title. Editor. Excerpt. Thumbnail. Revisions. Page attributes. Custom fields. Query Product Posts Query Product Categories Product Types Product types: Software kinds: Price Concepts Prices store: Product ID. Name. Slug. Amount in minor units. Currency. Active state. Checkout visibility. Billing interval. Billing read more
-
Frontend Shortcodes And Blocks
Shortcodes Registered shortcodes include: Pricing Table Examples Buy Button Example Render from PHP: Checkout Examples Account Portal Examples Blocks Shortcode-backed blocks: Native product and pricing blocks: Pricing Table Block Markup Single Product Layout Example Pricing Grid Template Example Editor Products Endpoint The block editor preview endpoint: It requires edit_posts. read more
-
Checkout REST API
Routes Checkout routes are public at the REST permission layer. Validation, gateway verification, completion tokens, and server-authoritative totals protect the flow. Quote Request Create Checkout Stripe Confirm Stripe Setup Intent Confirm PayPal Capture Location Hint JavaScript Quote Example Checkout Hooks read more
-
Portal REST API
Portal routes require a logged-in WordPress user linked to an AweCommerce customer. Routes Request Helper Update Profile Create Address Cancel Subscription Deactivate License Domain Download Invoice Error Mapping Portal errors map to: Use 404 for non-owned resources to avoid ownership leaks. read more
-
Admin REST API
Admin routes require WordPress authentication and AweCommerce capabilities. Routes Fetch Products In Admin JavaScript Create Product Create Coupon Create Grant Revoke Grant Source Refund Order read more
-
Licensing REST And Signed Requests
Routes Activation With License Key Activation With Bootstrap Token Activation Response Handling Store: Signed Request Canonical String The bundled client signs status and update checks with: Headers: Signed Status Request The status response can include license.runtime_behavior and license.chargeback_runtime_behavior. Clients should persist refreshed values even when the license is rejected with a structured response. Update Check read more
-
Client SDK Integration
SDK Location Bundle the client SDK in each licensed product: Theme: Plugin Registration Theme Registration Passive Metadata File: Example: Do not place license keys, bootstrap tokens, package tokens, site secrets, customer emails, or domains in passive metadata. Latest Bundled Client Behavior The bundled client: Registers a license menu page for each product. Shows admin notices read more
-
Software Releases Packages And Manifests
Canonical Package Rules Canonical packages must not contain: Plugin Package Structure Theme Package Structure Plugin Header Theme Header Manifest Path Manifest Must Not Include Example Manifest Fields Personalized Payload Bootstrap token payload: Full key payload: Prefer bootstrap tokens for normal first-install packages. Package Token Download The package download response sets: Build Verification Script Example read more
-
Gateway Integration
Gateway Interface Gateway adapters implement methods for: Gateway Skeleton Gateway Design Rules Keep totals server-authoritative. Use idempotency keys for charge and refund calls when provider supports them. Verify webhook signatures before mapping events. Store ignored provider events for review. Do not create subscriptions from one-time payment gateways. Do not advance subscription access without provider payment read more
-
Hooks Filters And Helpers
Lifecycle Orders Example: Subscriptions Example: Payments Entitlements Checkout Email Portal And Magic Links Access Filters Other Filters Helper Functions read more
-
WP CLI
Root Command Product Commands Create with grants: Grant Commands Coupon Commands API Key Commands Queue Commands Migration Command read more
-
Queue Cron And Jobs
Job Statuses Built-In Jobs Queue CLI Production Cron Use a real system cron for production: Queue Hooks Job Troubleshooting Flow read more
-
Emails Invoices And Notifications
Email Templates Template classes include: Filter Email Message Override Email Send Filter Layout Invoice Download Routes Notification Hook Create A Custom Notification Listener read more
-
Privacy Security And Compliance
Privacy Domains Privacy exporters include: Eraser behavior includes: Cancelling open subscriptions. Deleting addresses. Deleting notes. Anonymizing logs. Anonymizing payment methods. Anonymizing magic links. Anonymizing order checkout context. Anonymizing transactions. Anonymizing license sites and events where allowed. Security Headers Security headers include: Secret Redaction Helper Safe Redirect Filter Do Not Put Secrets In License Key Caveat read more
-
Integration Recipes
Fulfill External Service After Payment Send Purchase Event To Analytics Add Staff Access Override Route Magic Links To Account Page Add Custom Invoice Footer Disable Store Gateway For Checkout Context Custom Portal Profile Request read more
-
Status Reference
Order Statuses Refund Statuses Invoice Statuses Transaction Statuses Transaction Types Subscription Statuses Dunning Attempt Statuses Entitlement Statuses Coupon Types Coupon Durations License Statuses Software Release Statuses Package Token Statuses Package Usage Types License Source Types ACL Actions ACL Target Types read more
-
Troubleshooting
Checkout Returns Invalid Checkout Check: Log server-side context without secrets. Signed License Request Fails Check: Native Update Does Not Appear Check: Client License Page Does Not Appear Check: Also confirm the current user can manage site settings. Portal Returns 404 For Existing Resource This usually means the logged-in customer does not own the resource. Check: read more