Affiliates
The Affiliates screens provide a read-only view of the affiliate partner program managed by SolidAffiliate. MIDDAG Account reads data from SolidAffiliate's tables through an adapter pattern -- affiliate records are not created or edited in MIDDAG Account. When a new affiliate is approved in SolidAffiliate, MIDDAG Account automatically provisions an AFL-class entitlement to track the partnership.
How affiliates connect to MIDDAG Account
The integration works as follows:
- A partner signs up through the SolidAffiliate registration form.
- An admin approves the affiliate in SolidAffiliate.
- SolidAffiliate fires the
solid_affiliate/affiliate/approvedhook. - MIDDAG Account's
AffiliateHookslistener creates an AFL-class entitlement for the partner. - The affiliate appears in MIDDAG Account with their referral data.
The SolidAffiliate plugin must be active for affiliate data to appear. If SolidAffiliate is not installed, the Affiliates menu item is hidden.
Partner list
The main Affiliates screen shows a table of all affiliate partners:
| Column | What it shows |
|---|---|
| Name | Affiliate partner name |
| Contact email | |
| Status | Active, Pending, or Inactive |
| Entitlement | The AFL-class entitlement code (clickable) |
| Referrals | Total number of referrals generated |
| Earned | Total commission earned (lifetime) |
| Pending | Commission amount pending payout |
| Joined | Date the affiliate was approved |
Filters
- Search -- type an affiliate name or email
- Status -- filter by Active, Pending, Inactive, or All
Referral tracking
Click any affiliate name to open their detail view. The Referrals tab shows:
| Column | What it shows |
|---|---|
| Date | When the referral occurred |
| Customer | The referred customer name |
| Order | The WooCommerce order from the referral (clickable) |
| Amount | Order amount |
| Commission | Commission earned from this referral |
| Status | Approved, Pending, or Rejected |
Referral data is read from SolidAffiliate. Clicking an order number opens the order detail in MIDDAG Account.
Commission reports
The Commissions tab shows an aggregate view:
| Metric | Description |
|---|---|
| Total Earned | Lifetime commission total |
| Pending Payout | Approved commissions not yet paid out |
| Paid Out | Total already disbursed |
Below the summary, a monthly breakdown table shows commission earned per month.
Payout management
The Payouts tab shows the payout history:
| Column | What it shows |
|---|---|
| Date | Payout date |
| Amount | Amount paid |
| Method | Payment method (bank transfer, PayPal, etc.) |
| Status | Completed or Processing |
| Reference | Transaction reference number |
Payouts are managed in SolidAffiliate. MIDDAG Account displays the history for reference but does not process payouts directly.
SolidAffiliate integration status
At the top of the Affiliates screen, a status bar shows:
- SolidAffiliate Plugin -- Active (green) or Not Found (red)
- Affiliate Count -- total registered affiliates
- Pending Approvals -- affiliates awaiting approval (links to SolidAffiliate admin)
If SolidAffiliate is not active, the screen shows a notice explaining that the affiliate features require the SolidAffiliate plugin.
Related pages
- Entitlements -- AFL-class entitlements created for affiliates
- Orders -- orders generated through affiliate referrals
- Integrations -- SolidAffiliate connection status
- Entitlement Classes -- how AFL class works