Skip to content

Payout Batch Management Admin Manual

Module: Payout Management (M6)

Product: ebosAi AMP
Classification: Internal — Confidential
Role: Admin Only
Version: 2.0

1. Overview

The Payout Management screen at /admin/payouts enables Company Administrators to aggregate all cleared, approved commissions into structured payment batches, export banking wire CSV files, track disbursements, and finalize settlements.

stateDiagram-v2
    [*] --> Pending : Admin Previews & Creates Batch
    Pending --> Processing : Bank Wire Uploaded / Transfer Initiated
    Processing --> Completed : Wire Cleared + Reference Stored (Commissions -> posted)
    Processing --> Failed : Wire Rejected (Commissions return to approved)
    Completed --> [*]

2. Creating a Payout Batch

  1. Navigate to /admin/payouts and click Create Payout Batch.
  2. Select Date Range: Choose the Period Start and Period End dates for the settlement cycle.
  3. Click Preview Calculations. The system will:
  4. Aggregate all commissions with status approved within the date range.
  5. Filter out any partners whose total approved earnings fall below the tenant's minimum threshold ($50.00 default).
  6. Display a summary breakdown showing partner names, commission counts, masked banking details, and total net payout.
  7. Click Confirm & Generate Batch.
  8. The batch is created in pending status, locking the linked commission notes from duplicate batch assignments.

3. Disbursing Funds & Exporting CSV

  1. Open the created batch details.
  2. Click Export Banking CSV.
  3. The platform downloads a formatted CSV containing:
  4. Partner Full Legal Name
  5. Bank Name & Country
  6. Masked Account / IBAN Number
  7. SWIFT / Routing Code
  8. Total Amount & Currency
  9. Upload the CSV to your corporate banking portal or issue the wire transfers.

4. Finalizing Batch Status

  • Mark Completed: Once bank wires clear, click Mark Completed on the batch.
  • Enter the bank's wire settlement reference code (e.g. WIRE-20260807-9942).
  • The batch status transitions to completed.
  • All linked commission notes automatically transition from approved to posted.
  • Mark Failed: If a wire is returned or rejected by the banking network:
  • Click Mark Failed.
  • Enter the bank return reason (e.g., "Invalid IBAN checksum").
  • The batch transitions to failed, and all associated commission notes return safely to the approved pool for future re-processing.