Skip to main content

Affiliate Payout Runs and Reconciliation

Group due commissions into payout runs, complete PayPal or Wise payments, reconcile results, and recover retryable failures.

Table of Contents

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, confirm AffiliateBase has enabled both onboarding and execution access, the merchant has acknowledged the beta, the Stripe connection is active, the source Financial Account is configured and funded for the payout currency, and each selected recipient is currently eligible.

If Stripe payout execution access is not enabled, New Payouts remains unavailable for accounts using the Stripe payout method. Recipient onboarding or method selection alone does not create a payout run, submit money to Stripe, or establish paid status. 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 uses Stripe Global Payouts (Beta), AffiliateBase revalidates the platform gates, merchant acknowledgment, active connection, source Financial Account and currency funding, and current recipient eligibility before idempotent submission. Stripe controls final eligibility, fees, timing, and supported destinations. Confirm the resulting payout and provider-attempt state instead of treating onboarding or submission as proof of payment.

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