Athenian OwlPay
product details.
Athenian OwlPay orchestrates payout workflows for vendors, affiliates, creators, providers, and other platform participants with payable balances, payout execution, and reconciliation records. It helps teams turn earnings generated across the platform into trackable payable balances and payout-ready activity while keeping data, permissions, and automation aligned with the broader Athenian Platform Ecosystem.
Athenian OwlPay is the unified outbound payments and payout-orchestration layer for the Athenian Platform. It centralizes payee identity, payout methods, payable ledger entries, payout batching, payout execution, provider references, reconciliation metadata, and finance-core infrastructure inside WordPress and WooCommerce.
Where WooCommerce focuses on money coming in, OwlPay focuses on money going out. It gives vendors, affiliates, creators, service providers, marketplace participants, and other payees a structured path from earned balance to queued payout to sent, failed, or reconciled payment. Instead of scattering payout logic across dropship modules, affiliate tools, provider dashboards, spreadsheets, and manual admin actions, OwlPay provides one shared payout runtime that other Athenian plugins can credit, debit, batch, execute, audit, and extend.
The plugin includes a canonical payee registry, per-payee payout methods, a payable ledger, payout rows, payout-item reservations, admin screens, frontend payout profile shortcodes, WooCommerce My Account integration, PayPal Payouts support, manual payout workflows, Stripe Connect scaffolding, dropship/vendor integrations, affiliate integrations, Social Users/People payout profiles, APS recurring payment bridge support, Secure API credential handling, WP-CLI diagnostics, REST health/webhook routes, and a finance-core foundation for chart of accounts, entities, journals, journal lines, and balances.
For Athenian Platform builds, OwlPay is best positioned as the payout and financial-core foundation for vendor payouts, affiliate commissions, creator earnings, service-provider disbursements, marketplace settlements, recurring payment automation, and future accounting/reporting workflows.
How Athenian OwlPay fits the Athenian Platform
Platform role: Athenian OwlPay is a focused capability in the Payments, Credits & Payouts and Vendor, Marketplace & Multi-Party Commerce layer. Its primary scope covers Creator & Affiliate Marketplaces and Payouts, Ledger & Settlement while remaining composable with the other modules an implementation actually requires.
Connected scope: Athenian OwlPay 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.
Payout Foundation
Centralize Payees, Payout Methods, and Payable Balances
Athenian OwlPay gives the platform one canonical payout registry for vendors,
affiliates, People records, creators, partners, and future payee types, with
ledger-backed balances and provider-specific payout methods.
| Payout Layer | Operational Value |
|---|---|
| Payee Registry | Store canonical payee records keyed by payee type and foreign/source ID, with display name, email, user linkage, status, currency, and default method. |
| Payout Methods | Maintain per-payee payout method records for manual payments, PayPal Payouts, Stripe Connect, or future payout rails. |
| Payable Ledger | Track credits, debits, availability dates, source references, memo fields, currency, status, and metadata in one operational ledger. |
| Source Traceability | Preserve where payout obligations came from, such as vendor purchase orders, affiliate earnings, People payouts, or upstream platform events. |
- Stores payees in
wp_ath_owlpay_payees. - Stores payout methods in
wp_ath_owlpay_payee_methods, with a legacy methods table retained for migration compatibility. - Stores payable movements in
wp_ath_owlpay_ledger. - Allows upstream plugins to credit or debit balances through
ath_owlpay/ledger/creditandath_owlpay/ledger/debit.
Payout Execution
Queue, Reserve, Execute, Retry, and Reconcile Payouts
OwlPay creates payout rows from eligible ledger entries, reserves the consumed
ledger items, executes payouts through registered adapters, finalizes successful
payouts, and releases failed payouts for retry.
Link payout rows to the exact ledger entries being consumed
Separate payout provider execution from core payout lifecycle logic
Store provider references, responses, errors, logs, and payout status history
| Execution Layer | How It Helps |
|---|---|
| Payout Rows | Create payout batches with subtotal, fee, total, currency, method, funding source, status, external reference, error message, and metadata. |
| Payout Items | Use a join table to reserve and trace the ledger entries consumed by each payout. |
| PayPal Payouts | Support single-recipient PayPal payout execution with OAuth token handling, sandbox/live mode, idempotency-friendly IDs, and response metadata. |
| Adapter Registry | Register manual, PayPal, Stripe Connect, or future payout rails through the adapter interface and extension hook. |
- Stores payout records in
wp_ath_owlpay_payoutsand payout-to-ledger links inwp_ath_owlpay_payout_items. - Built-in or represented adapters include
manual,paypal_payouts, andstripe_connect. - Allows custom payout rails through
ath_owlpay/register_adapters. - Includes WP-CLI tools such as
wp owlpay doctor,wp owlpay paypal:ping,wp owlpay credit,wp owlpay create, andwp owlpay exec.
Platform Finance Core
Connect Payout Profiles, Vendor Payables, Affiliate Earnings, and Finance Journals
OwlPay extends beyond admin payout rows with frontend payout profile tools,
WooCommerce My Account access, dropship/vendor integration, affiliate payout
workflows, Social Users/People linkage, APS renewal payment hooks, Secure API
credentials, and finance-core accounting tables.
| Platform Layer | Operational Purpose |
|---|---|
| Frontend Profiles | Let People-linked users configure payout details, review balances, and request payouts through shortcodes or the WooCommerce My Account OwlPay endpoint. |
| Vendor & Affiliate Integrations | Resolve vendor and affiliate payees, credit payable balances, display payout context, and queue payouts from specialized admin views. |
| Recurring Payment Bridge | Listen to APS renewal hooks and process off-session subscription renewal payments using stored WooCommerce payment tokens. |
| Finance Core | Add chart of accounts, financial entities, journal entries, journal lines, account mappings, posting rules, and materialized balances. |
The outbound payments backbone for Athenian commerce:
OwlPay gives marketplace, dropship, affiliate, creator, service-provider,
subscription, and financial reporting modules one shared payout and ledger
runtime instead of scattered one-off payment workflows.
- Supports frontend payout setup through shortcode names such as
'ath_owlpay_people_account','ath_owlpay_payment_profile','ath_owlpay_payout_onboarding', and'ath_owlpay_user_dashboard'. - Adds an OwlPay endpoint to WooCommerce My Account when WooCommerce is active.
- Registers secure credential groups such as
owlpay_paypal_payouts,owlpay_stripe_connect,owlpay_stripe_billing,owlpay_dwolla, andowlpay_ach. - Builds toward Stripe Connect completion, PayPal webhook hardening, tax-form onboarding, payout notifications, CSV exports, creator royalties, service-provider payouts, gift card/store-credit journal integration, and WPGraphQL reporting.