Viewing & Withdrawing Earnings

This page explains the states of affiliate earnings, how affiliates view balances, and options for withdrawing funds.

Earning lifecycle

Pending: a conversion has been recorded but is still within the refund/fulfillment window.
Approved: the conversion passed validation and is eligible for payout.
Paid: funds have been sent to the affiliate’s chosen payout method.

Viewing balances

Affiliates can view a summary panel showing pending, approved, and lifetime earnings.
Drilldown lists show the contributing conversions, with order id and date for audit purposes.

Withdrawal options

Automatic payouts: when merchants configure Stripe Connect auto-payouts, approved balances are paid on schedule.
Manual requests: affiliates can request withdrawals; admin reviews and processes payouts via CSV/export.
Minimum thresholds: merchants often set a minimum payout threshold to avoid micro-payments and reduce fees.

Tax & identity requirements

For some regions, merchants must collect tax or identity info (W9, VAT) prior to enabling payouts. Provide clear prompts in the affiliate profile.

Developer notes

For Stripe Connect flows, store the stripe_account_id per affiliate and use the Stripe API to initiate transfers.
Keep payout audit logs (who initiated, when, payout ids) and provide export for accounting.

Clear balance states, simple withdrawal flows, and transparent audit trails reduce disputes and improve affiliate trust.

Automatic payouts

Some programs use scheduled payouts (e.g., monthly) - you will be paid automatically when the schedule runs.

Fees, taxes, and thresholds

The merchant may apply minimum payout thresholds and processing fees. Check program terms for details.
Provide tax details when requested to avoid withholding or delays.

Withdrawal troubleshooting

If a payout is delayed, check the payout status in the Transactions view and contact support with the payout ID.

Records and reports

Export payout history from Dashboard > Payouts for your records or tax reporting.