Skip to content
Docs

Stripe Integration

Each app in BitEasy needs an attached payment method (credit card or debit card) to fund partner payouts. This page explains how to connect Stripe and manage payment methods.

Why Per-App Payment Methods?

Section titled “Why Per-App Payment Methods?”

BitEasy uses a per-app payment method model because:

  1. Revenue Isolation — Each app’s revenue and payouts are tracked separately
  2. Payout Funding — Partner payouts are charged to the app’s attached payment method (CC or debit)
  3. Multiple Apps — You can use different payment methods for different apps

Adding a Payment Method

Section titled “Adding a Payment Method”

From App Settings

Section titled “From App Settings”
  1. Navigate to your app’s Settings page
  2. Find the Payment Method section
  3. Click Add Payment Method (or select from existing methods)
  4. Enter your credit card or debit card details
  5. The payment method is now attached to your app

Using an Existing Payment Method

Section titled “Using an Existing Payment Method”

If you’ve already added a payment method for another app:

  1. Click the Payment Method dropdown
  2. Select from your available methods
  3. The method is linked immediately

Payment Method Requirements

Section titled “Payment Method Requirements”

Your payment method must be:

  • A valid credit card or debit card
  • Not expired or blocked by your bank
  • Able to process charges (sufficient funds or credit limit)

Payout Flow

Section titled “Payout Flow”

When partner payouts are processed:

flowchart LR
    A[Partner Earnings Accrued] --> B[Daily Payout Cron]
    B --> C[Charge Payment Method]
    C -->|Success| D[Transfer to Partner]
    C -->|Failed| E[Payout Failed]
    D --> F[Partner Receives Funds]
  1. Earnings accrue as purchases are attributed
  2. Daily at 03:00 UTC, the payout cron runs
  3. Your attached payment method (CC or debit) is charged for the payout amount
  4. Funds are transferred to the partner’s connected Stripe account

Payout Health

Section titled “Payout Health”

The Dashboard shows Payout Health status for each app:

StatusMeaningAction
HealthyPayment method attached and payouts processing normallyNone required
RiskNo payment method attached, or recent failed payoutsAttach or update your payment method

Managing Payment Methods

Section titled “Managing Payment Methods”

To view and manage payment methods for funding payouts:

  1. Navigate to Finances in the sidebar
  2. Click the Payment Methods tab
  3. Add, rename, replace, or delete payment methods

See Payment Methods for detailed management options.

Troubleshooting

Section titled “Troubleshooting”

”Not Connected” Status

Section titled “”Not Connected” Status”

If your app shows “Not Connected”:

  1. Go to Finances → Payment Methods
  2. Add a credit card or debit card
  3. Go to App Settings and select the payment method

Payment Method Declined

Section titled “Payment Method Declined”

If your payment method is being declined:

  1. Verify the card is not expired
  2. Check with your bank for any blocks on the transaction
  3. Try a different payment method

Payouts Delayed

Section titled “Payouts Delayed”

If payouts aren’t processing:

  1. Check Dashboard → Payout Health for risk alerts
  2. Ensure a valid payment method is attached to the app
  3. Review the Payouts tab for any failed payouts and their failure reasons

Next Steps

Section titled “Next Steps”