Why Manual Payouts Break at Scale
Manually calculating and processing affiliate commissions on in-app purchases works when you have 5 affiliates and 20 transactions per month. At 50 affiliates and 500 transactions, it becomes a full-day task. At 200 affiliates and thousands of transactions, it is impossible without errors.
Automating the entire pipeline — from purchase event to commission calculation to payout — eliminates errors, saves time, and builds affiliate trust through reliable, on-time payments.
The Automated Pipeline
Step 1: Purchase Event Capture
When a user makes an in-app purchase, the event must reach your affiliate tracking system:
- Subscriptions: RevenueCat or Adapty sends webhook events automatically for new purchases, renewals, and cancellations
- Consumable IAPs: Your app reports each purchase through the Insert Affiliate SDK or server API
- Web payments: Stripe webhook events forward to Insert Affiliate
Step 2: Attribution Matching
Insert Affiliate matches each purchase event to the affiliate who referred the purchasing user. This happens automatically based on the attribution stored when the user first clicked the affiliate link.
Step 3: Commission Calculation
The system applies your configured commission rules:
- Percentage of transaction value
- Different rates for different product types
- Tier adjustments based on affiliate performance level
- Clawback rules for refunded transactions
Step 4: Commission Accrual
Calculated commissions accrue in each affiliate's account balance. The affiliate sees their earnings update in real-time through their dashboard.
Step 5: Payout Processing
On your defined payout schedule (monthly, bi-monthly), the system processes payments for all affiliates whose balance exceeds the minimum threshold:
- Stripe Connect transfers funds directly to affiliate bank accounts
- Payment confirmations are sent automatically
- Transaction records are stored for reporting and tax purposes
Setting Up the Automation
- Configure purchase verification webhooks from your payment provider to Insert Affiliate
- Set commission rules for each product type in Insert Affiliate's dashboard
- Connect Stripe Connect for automated payout processing
- Define payout schedule and minimum threshold
- Test the full pipeline with sandbox transactions before going live
Handling Edge Cases Automatically
Refunds: When a refund webhook is received, the system automatically reverses the associated commission. If the payout has already been processed, the reversal is applied to the affiliate's next payout.
Subscription downgrades: When a user downgrades to a lower tier, future commissions adjust automatically to reflect the new subscription price.
Currency conversion: For international affiliates, the system handles currency conversion at the time of payout.
Failed payments: If a payout fails (invalid bank details, insufficient balance), the system flags the failure and retries on the next cycle. Alert notifications keep you informed.
What to Monitor
Even with full automation, monitor these weekly:
- Webhook delivery success rate (are all purchase events reaching Insert Affiliate?)
- Commission calculation accuracy (spot-check a few transactions monthly)
- Payout success rate (are payments going through without failures?)
- Affiliate balance trends (unusually high or low balances may indicate issues)
Insert Affiliate provides the tracking, calculation, and reporting layers of this pipeline. Pair it with Stripe Connect for the payment processing layer and you have end-to-end automation.
