Auto Chunk Payments

Split affiliate commission payments for specific in-app purchases into smaller chunks that appear on the affiliate dashboard at set intervals. This is useful for managing cash flow on high-value subscriptions — for example, splitting an annual subscription commission into 12 monthly payments instead of paying the full amount upfront.

Availability

Auto chunk payments is an Enterprise plan feature, currently available for RevenueCat transactions only. If you use a different purchase verification method and would like this feature, you can request it directly from the settings page.

How It Works

When a transaction comes in for a product that has a chunk rule configured:

1. The original commission is calculated as normal (e.g. 30% of a $99.99 annual subscription = $30.00)
2. Instead of showing the full $30.00 as a single payment, it's split into smaller chunks (e.g. 12 x $2.50)
3. The first chunk is available immediately
4. Subsequent chunks become available on the schedule you choose (monthly on the 1st of each month, or at a custom day interval)
5. Affiliates only see chunks that have become available — future chunks are hidden from their view
6. Only available chunks count towards the affiliate's total owed balance

The original transaction is still recorded for audit purposes but is excluded from all totals and payment displays.

Setting Up Chunk Rules

1. Go to Settings
2. Scroll to the Auto Chunk Payments section
3. Click Add Chunk Rule
4. Configure the rule:

Setting	Description
IAP Product ID	The in-app purchase product ID to apply chunking to (e.g. com.yourapp.annual_subscription). Must match the product ID exactly as it appears in your RevenueCat transactions.
Number of Chunks	How many payments to split the commission into (minimum 2, maximum 20).
Schedule Type	Choose Monthly (1st of each month) to release chunks on the 1st of each following month, or Custom interval (days) to set a specific number of days between each chunk.
Days Between Chunks	Only shown for custom interval schedules. The number of days between each chunk becoming available (e.g. 7 for weekly, 30 for approximately monthly).

5. Click Save to apply

Each product ID can only have one chunk rule. Changes only apply to future transactions — existing chunked payments are not affected.

Example

You sell an annual subscription at $99.99 with a 30% affiliate commission ($30.00). You configure a chunk rule with 12 monthly chunks:

• Chunk 1 ($2.50): Available immediately when the purchase happens
• Chunk 2 ($2.50): Available on the 1st of the next month
• Chunk 3 ($2.50): Available on the 1st of the month after that
• ...and so on through Chunk 12

The affiliate sees each chunk appear on their dashboard as it becomes available. Their total owed balance only includes chunks that have reached their available date.

Viewing Chunked Payments

As a Company Admin

When viewing an affiliate's transactions in Search Affiliate, you'll see a Chunked Payments tab if the affiliate has any chunked transactions. This tab shows:

• Summary cards: Available total, Paid, Unpaid, and Scheduled amounts
• Available chunks: Chunks that have reached their available date, with the ability to mark as paid or pay via Stripe
• Scheduled chunks: Future chunks that haven't reached their available date yet, shown greyed out with their scheduled date
• Cancelled chunks: Any chunks that were cancelled due to a refund

Click the info icon next to any chunk number to see all chunks for that transaction grouped together, showing their status at a glance.

The original transaction (e.g. the full $30.00 commission) is hidden from the In App Transactions tab to avoid double-counting. It still exists in the database for audit purposes.

As an Affiliate

Affiliates see their available chunks in the Chunked Payments tab on their dashboard. They can only see chunks that have already become available — future scheduled chunks are not visible. This means their total owed balance accurately reflects what is currently payable.

Refunds

If a customer receives a refund for a chunked product, matching negative refund chunks are created for each original chunk:

• Refund chunks have the same available date as the original chunk they offset
• Available chunks get an immediate negative refund chunk, netting them to $0
• Future chunks also get a matching negative refund chunk at the same scheduled date, so when that date arrives both the original chunk and its refund appear together, netting to $0
• Nothing is hidden or cancelled — the full audit trail is preserved

Things to Note

• Only one chunk rule can be set per product ID
• Chunking only applies to RevenueCat in-app transactions (not Stripe web billing)
• The commission percentage or fixed amount is calculated as normal before chunking — chunking only affects how the resulting amount is split and displayed
• Rounding: if the commission doesn't divide evenly, earlier chunks receive the rounded-down amount and the final chunk absorbs any remainder to ensure the total is exact
• Chunk rules are snapshotted at creation time — if you change a rule, only future transactions are affected