Skip to main content

Payout Runs and Reconciliation

Create payout runs, execute payouts, and remediate failed payout states

Table of Contents

Payout Runs and Reconciliation

Payout operations are run-centric. A payout run groups eligible due commissions into payout records, then tracks whether those payouts were exported, processed, marked paid, or sent back for remediation.

Core Workflow

  1. Open Payouts.
  2. Choose New Payouts.
  3. Review eligible affiliates and payout totals.
  4. Create the payout run.
  5. For PayPal or Wise, create the provider export and complete payment outside AffiliateBase.
  6. For Stripe Global Payouts beta accounts, execute the run only after every selected recipient is active and the Stripe Financial Account is funded.
  7. Mark confirmed exported payouts paid.
  8. Use Reconcile to review recent run health and remediate unresolved states.

Only commissions in due state are eligible for new payout grouping.

Payment Behavior

  • If account payout method is paypal, generate PayPal exports, pay affiliates in PayPal, and then mark/reconcile paid.
  • If account payout method is wise, generate Wise exports, pay affiliates in Wise, and then mark/reconcile paid.
  • If the account has explicitly enabled Stripe Global Payouts (Beta), AffiliateBase revalidates recipient readiness and submits an idempotent Stripe outbound payment. Stripe controls final eligibility, fees, timing, and supported destinations.

Reconciliation

Use Payouts -> Reconcile for recent run health checks and remediation actions.

The reconciliation view helps you find:

  • runs with unpaid or failed payouts
  • payouts stuck in processing
  • missing recipient details
  • provider errors or payment references that need review

Typical Remediation Actions

  • Retry unpaid payouts
  • Review export results and payment references
  • Reset stuck processing payouts
  • Refresh recipient onboarding when a Stripe payout recipient is incomplete
  • Follow funding guidance when a provider reports insufficient funds

For PayPal and Wise exports, do not mark a payout paid until the external provider confirms the money was sent.

Partial Provider Success

If only some rows in a PayPal or Wise file were paid, do not mark the original full export paid. Delete or replace the original export, create a new export for the rows that actually succeeded, and mark only that successful export paid. Leave failed payouts open for correction and retry.

Next steps