# 3. Payment Requests & Payouts

User Type: **Affiliate**
Source: *Mi Digital Academy - Education CRM Features Document*

---

## 3. Payment Requests & Payouts

### 3.1 Payment Request Submission
**What it does:** Lets the Affiliate submit a payment request for their earned commission, once it meets the minimum payout threshold. The Affiliate selects the amount, confirms the payment method, and submits the request. The request is processed and the status is tracked. This is how the Affiliate gets paid.

**Sub-features:**
- Submit a payment request
- Minimum payout threshold check
- Select the payment method
- Confirm the request amount
- Request status tracking (pending, processed, paid)
- Request available on web and mobile
- Request event logging (submitted, processed)
- Audit logging of the payment request submission

**Affiliate User Journey:**
1. Affiliate opens the payment requests.
2. Affiliate submits a payment request.
3. The minimum payout threshold is checked.
4. Affiliate selects the payment method.
5. Affiliate confirms the request amount.
6. The request status is tracked.
7. Affiliate opens Profile → "Activity" and confirms the request events are recorded.

**Rules & Edge Cases:**
- The request requires the minimum payout threshold.
- The request status is tracked.
- Request events (submitted, processed) are logged with the account and the timestamp.
- The payment request submission is audit-logged with the account and the timestamp.

### 3.2 Payment History
**What it does:** Shows the Affiliate their payment history: each payout with the amount, date, method, and status. The Affiliate can view the details of each payment and filter by period. This provides a complete record of their payouts.

**Sub-features:**
- List of payment history
- Amount, date, method, and status per payment
- View a payment's details
- Filter by period
- Payment history available on web and mobile
- History event logging (viewed)
- Audit logging of the payment history

**Affiliate User Journey:**
1. Affiliate opens the payment history.
2. The list of payment history is shown.
3. Each payment shows the amount, date, method, and status.
4. Affiliate views a payment's details.
5. Affiliate filters by period.
6. The payment history is displayed.
7. Affiliate opens Profile → "Activity" and confirms the history events are recorded.

**Rules & Edge Cases:**
- The history shows amount, date, method, and status.
- The history can be filtered by period.
- History events (viewed) are logged with the account and the timestamp.
- The payment history is audit-logged with the account and the timestamp.

### 3.3 Payment Statements
**What it does:** Provides the Affiliate with downloadable payment statements: a formal record of each payout for their records and tax purposes. The Affiliate can view and download the statements. The statements are accurate and complete. This supports the Affiliate's financial record-keeping.

**Sub-features:**
- List of payment statements
- View a statement
- Download a statement
- Statement for each payout
- Statements are accurate and complete
- Statements available on web and mobile
- Statements event logging (viewed, downloaded)
- Audit logging of the payment statements

**Affiliate User Journey:**
1. Affiliate opens the payment statements.
2. The list of payment statements is shown.
3. Affiliate views a statement.
4. Affiliate downloads the statement.
5. The statement is for each payout.
6. The statements are accurate and complete.
7. Affiliate opens Profile → "Activity" and confirms the statements events are recorded.

**Rules & Edge Cases:**
- The statements are per payout.
- The statements are accurate and complete.
- Statements events (viewed, downloaded) are logged with the account and the timestamp.
- The payment statements is audit-logged with the account and the timestamp.
