Payouts

The Payouts tab shows all payout batches to your partners, including pending and completed transfers.

Viewing Payouts

Navigate to Finances → Payouts tab.

The table displays:

Column	Description
Partner	Who is receiving this payout
App	Source app for the earnings
Amount	Total payout amount
Status	Current payout status
Earnings	Number of earnings included
Created	When the payout batch was created
Completed	When the transfer finished (if complete)

Payout Status

Payouts progress through these statuses:

Status	Description	Action
Queued	Created by cron, waiting for processing	Automatic
Charging	Your payment method is being charged	Automatic
Charged	Payment captured, transfer pending	Automatic
Transferring	Funds moving to partner’s account	Automatic
Paid	Transfer completed successfully	None needed
Failed	Charge or transfer failed	Investigate cause
Reversed	Transfer was reversed	Earnings marked void

The Payout Cron

The daily payout cron:

Collects earnings — Finds all Accrued earnings
Groups by partner — Each partner gets one payout
Checks thresholds — Must meet each referral link’s minimum payout
Verifies requirements — App must have billing entity, partner must have Stripe account
Creates batches — Queues payout records
Charges your payment method — Your card is charged for the payout amount
Transfers to partner — Funds move to partner’s Stripe account

Minimum Payout Threshold

Each referral link has a minimum payout amount set at creation time (default $25.00):

Partner’s accrued earnings must exceed this threshold
If below, earnings remain accrued until threshold is met
The threshold is locked when the referral link is created and cannot be changed

Payout Lifecycle

flowchart TB
    A[Daily Cron - 03:00 UTC] --> B{Partner eligible?}
    B -->|Yes| C[Payout - Queued]
    B -->|No| D[Skip - below threshold]
    C --> E[Charge Payment Method]
    E --> F{Charge succeeds?}
    F -->|Yes| G[Payout - Charged]
    F -->|No| H[Payout - Failed]
    G --> I[Transfer to Partner]
    I --> J{Transfer succeeds?}
    J -->|Yes| K[Payout - Paid]
    J -->|No| L[Payout - Failed]
    H --> M[Retry available]
    L --> M

Filtering Payouts

Use the filter bar to narrow results:

By Status

All statuses
Queued
Processing
Paid
Failed
Reversed

By App

Filter to payouts from a specific app.

By Partner

Filter to a specific partner.

By Date Range

Set custom start and end dates.

Failed Payouts

Payouts can fail at two stages:

Charge Failures

If charging your payment method fails:

Status changes to Failed
Earnings remain linked to the failed payout
You can retry the payout or it will auto-recover after 7 days

Common charge failure causes:

Cause	Solution
Card declined	Update your payment method in billing settings
Insufficient funds	Ensure card has available balance
Card expired	Add a new payment method
Authentication required	Complete 3D Secure verification in dashboard

Transfer Failures

If the charge succeeds but transfer fails:

Status changes to Failed or Needs Attention
Funds have already been charged from your payment method
May require manual intervention

Common transfer failure causes:

Cause	Solution
Partner account restricted	Partner needs to resolve with Stripe
Partner account not verified	Partner must complete Stripe onboarding
Transfer limit exceeded	Contact Stripe support

Reconciliation

BitEasy automatically reconciles payouts with Stripe:

Stripe webhook confirms payment intent succeeded
Transfer is initiated to partner’s account
Stripe webhook confirms transfer completion
Payout status updates to Paid
Associated earnings update to Paid

Next Steps

Payment Methods — Manage payment methods for payouts
Stripe Integration — Understand per-app setup