Skip to content

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:

  1. A partner signs up through the SolidAffiliate registration form.
  2. An admin approves the affiliate in SolidAffiliate.
  3. SolidAffiliate fires the solid_affiliate/affiliate/approved hook.
  4. MIDDAG Account's AffiliateHooks listener creates an AFL-class entitlement for the partner.
  5. 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:

ColumnWhat it shows
NameAffiliate partner name
EmailContact email
StatusActive, Pending, or Inactive
EntitlementThe AFL-class entitlement code (clickable)
ReferralsTotal number of referrals generated
EarnedTotal commission earned (lifetime)
PendingCommission amount pending payout
JoinedDate 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:

ColumnWhat it shows
DateWhen the referral occurred
CustomerThe referred customer name
OrderThe WooCommerce order from the referral (clickable)
AmountOrder amount
CommissionCommission earned from this referral
StatusApproved, 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:

MetricDescription
Total EarnedLifetime commission total
Pending PayoutApproved commissions not yet paid out
Paid OutTotal already disbursed

Below the summary, a monthly breakdown table shows commission earned per month.

Payout management

The Payouts tab shows the payout history:

ColumnWhat it shows
DatePayout date
AmountAmount paid
MethodPayment method (bank transfer, PayPal, etc.)
StatusCompleted or Processing
ReferenceTransaction 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.