Overview
The Payouts and Commissions feature manages affiliate earnings, partner invoices, and financial distributions. It handles the complete lifecycle of commission payouts—from approval and invoicing to multi-channel distribution—supporting multiple payout providers including Stripe, PayPal, and Stablecoin.
Payout Methods
Partners can receive earnings through several supported payout methods, each with specific processing times and requirements.
Supported payout providers: connect (Bank Account), stablecoin (USDC Crypto Wallet), paypal (PayPal), tremendous (Gift Card)
Sources: apps/web/ui/partners/payouts/payout-method-config.ts, apps/web/lib/constants/payouts.ts
| Method ID | Title | Description & Processing Time |
|---|---|---|
connect | Bank Account | Paid in local currency; deposited in 2-5 business days via Stripe Connect. Local bank account required. |
stablecoin | Stablecoin | Paid in USDC with a 0.5% payout fee; deposited in minutes. No local bank account required. |
paypal | PayPal | Paid in local currency with a 3% FX fee; deposited in 5-10 business days. |
tremendous | Gift Card | Delivered via gift card email; typically arrives in minutes. |
Note
Stablecoin payouts incur a 0.5% fee rate and a fixed 0.50 USD fee per transaction to cover network transfer costs.
Approving Commissions and Processing Payouts
Reviewing and Confirming Payouts
Workspace administrators can review eligible partner commissions and generate invoices to fund payouts by following these steps:
- Review Eligible Payouts: Navigate to the payouts dashboard within your workspace to view accumulated partner commissions that have cleared the program's holding period.
- Configure Payout Parameters: Select the payouts you want to include, choose your payment method, and set optional cutoff periods.
- Confirm and Process: Confirm the payout batch to generate an invoice. The system validates payment details, calculates applicable payout fees, and creates a payment intent to fund the transfers.
Warning
If an invoice includes external payouts, you must have an active webhook subscribed to the payout.confirmed event before proceeding, otherwise the request will be rejected.
Handling Refunds and Adjustments
When customer payments are refunded or disputed, associated commission statuses and balances are automatically adjusted to reflect the change in funds.
- Holding Periods: Payouts remain in a
pendingstatus during the program's holding period (options include0,7,14,30,60, or90days) to account for potential refunds. - Failed Charges: If an invoice payment fails or is reversed before funds settle, automated cron jobs pause payout distribution to prevent advancing uncollected funds.
Issuing Invoices
Invoices are automatically generated when a payout batch is confirmed.
- Invoices for Programs: Workspace administrators can view invoice summaries detailing total payout amounts, platform fees, and net charges.
- Invoices for Partners: Partners can view and download individualized PDF invoices for completed payouts directly from their partner dashboard (
/invoices/[payoutId]). These documents include program details, payout amounts, transaction reference numbers, and applicable VAT or GST reverse-charge notices for international partners (such as EU countries or Australia).
Sending Payouts via Stripe, PayPal, or Stablecoin
Once an invoice charge succeeds, the system automatically routes funds through the partner's designated payout method:
- Stripe Transfers (
connect): Funds are transferred directly to the partner's connected Stripe account. For card payments, source transaction references are included to handle fast settlements. - PayPal Payouts (
paypal): Payout items are batched and sent via PayPal's batch payout API to the partner's registered PayPal email. - Stablecoin Payouts (
stablecoin): Dub funds its internal financial account, deducts the0.5%stablecoin fee, and transfers USDC directly to the partner's connected crypto wallet via Stripe's recipient crypto capabilities.
Tip
If a partner's payout amount falls below the minimum withdrawal threshold of $10.00, the payout is marked as processed and held for up to 90 days. Partners can manually trigger an instant withdrawal by selecting "Pay out now" on their dashboard, which incurs a small withdrawal fee of $0.50.