Commission Engine & Earnings User Manual¶
Module: Commission Engine (M5)¶
Product: ebosAi AMP
Classification: Public / End-User Documentation
Version: 2.0
1. Commission Models¶
The ebosAi Commission Engine calculates partner rewards automatically when attributed conversions take place. Merchants configure one of two primary commission models:
- Percentage Model (Default):
- You receive a set percentage of the customer's purchase or subscription value (e.g., 15% of a $100 plan = $15.00).
- Lump Sum / Flat-Fee Bounty:
- You receive a fixed cash bounty for every qualified new customer signup (e.g., $50.00 flat per Pro signup).
Merchants can also establish Partner Tiers (Standard, Silver, Gold) that provide increasing commission rates as your referral volume grows.
2. Commission Status Lifecycle¶
Every commission note progresses through defined lifecycle stages:
stateDiagram-v2
[*] --> Pending : Conversion Attributed
Pending --> Approved : Holding Period Cleared (30 Days)
Pending --> Rejected : Fraud / Customer Refund / Cancellation
Approved --> Posted : Payout Batch Settled & Transferred
Posted --> [*]
Lifecycle Definitions:¶
| Status | Description | Action Required |
|---|---|---|
pending |
Newly created upon conversion. Held during the merchant's holding period (typically 30 days) to protect against chargebacks and refunds. | None. Awaiting automatic maturity. |
approved |
The holding period has elapsed without refund. The commission is verified and queued for payout. | Ensure bank details are saved in profile. |
posted |
The commission has been included in a completed payout batch and transferred to your bank/payment account. | Check your bank statement. |
rejected |
The customer refunded, cancelled during trial, or failed anti-fraud checks. | Check rejection reason note. |
cancelled |
Administrative adjustment by the program manager. | Contact support if disputed. |
3. Auditing Your Earnings¶
- Navigate to the Earnings tab in your partner portal (
/partners/earnings). - The earnings table displays:
- Conversion Date: Timestamp when customer registered.
- Product: Specific plan or subscription purchased.
- Order Amount: Gross customer transaction value.
- Commission Rate: Applicable percentage or flat rate.
- Net Commission: Your exact earnings.
- Status Badge: Visual indicator of the current lifecycle stage.
- Click Export CSV to download a spreadsheet containing full audit data for tax filing.