A refund can turn a correct affiliate payout into an overpayment in one billing cycle. Rewardful affiliate refunds need a fixed review process, not a dashboard check five minutes before a payout run.
Stripe records the money movement. Rewardful records the referred sale and the commission tied to it. Your team needs both records to agree before any commission moves from Pending to Paid.
Use the workflow below to track full refunds, partial refunds, late adjustments, and disputed records without losing the audit trail.
RECONCILE REWARDFUL AFFILIATE REFUNDS AGAINST STRIPE
Rewardful connects to Stripe customer records, invoice payments, and refund events. Stripe sends refund notifications through the integration. Rewardful then checks for a related commission and updates it.
Review how Rewardful uses Stripe data before you set internal payout rules. Rewardful can read the billing data it needs for attribution and commissions. It cannot issue customer refunds or move money from your Stripe account.
Stripe is the payment record
Use Stripe as the source of truth for whether money was collected or returned. Verify the customer, invoice, PaymentIntent or Charge, payment date, refund amount, and refund status there.
A refund is created against a successful Charge or PaymentIntent. Stripe supports full and partial refunds. Its refund documentation also confirms that a refund can take time to reach the customer’s original payment method.
Do not calculate an affiliate adjustment from a support ticket or a canceled subscription alone. Confirm that Stripe processed the actual refund.
Rewardful is the commission record
Use Rewardful to verify the affiliate, campaign, commission amount, and commission state. A commission can be Pending, Due, or Paid. Pending is a hold state. Due means it cleared the configured hold period. Paid means it entered a completed payout record.
Rewardful’s standard commission hold period is 30 days unless you configure another period. Read the Rewardful commission timing rules and set your hold period to match your real refund policy.
A customer cancellation is not always a refund. Treat it as a commission event only after the Stripe payment and refund records show the money outcome.
BUILD A FIXED REFUND RECONCILIATION RECORD
Do not rely on a filtered dashboard view as your only record. Export a payout snapshot before each payout run. Keep that snapshot unchanged after the run.
Create one reconciliation row for each paid invoice that produced a commission. A customer may have several subscription invoices. Each invoice needs its own review.
| Field | Verify in Stripe | Verify in Rewardful |
|---|---|---|
| Customer identity | Customer ID and billing email | Referred customer and affiliate |
| Revenue event | Invoice, Charge or PaymentIntent ID | Conversion or commission record |
| Original amount | Amount paid and currency | Commission basis and amount |
| Refund activity | Refund ID, amount, date, status | Updated, reduced, or removed commission |
| Payout status | Not applicable | Pending, Due, Paid, or voided record |
| Review evidence | Export, receipt, and refund record | Commission export and campaign record |
This record gives finance one place to trace a payout back to a real payment. It also stops a common mistake, matching a commission to the customer but not to the correct renewal invoice.
Record the original result and the correction separately
Keep the original commission row. Add a separate adjustment row when a refund changes the amount. Include the refund ID, adjustment amount, reviewer, decision date, and payout impact.
For example, a customer pays a $1,000 annual invoice. The affiliate earns 20%, so the original commission is $200. Stripe later processes a $250 refund. The retained sale is $750. The revised percentage commission is $150, and the adjustment is negative $50.
Do not overwrite $200 with $150 and move on. Finance needs to see what changed, when it changed, and why.
HANDLE FULL REFUNDS BEFORE COMMISSIONS BECOME DUE
A full refund means the customer received the entire payment amount back. When Rewardful receives the Stripe refund event for an invoice with a commission, it removes the related commission.
Start in Stripe. Open the refund and confirm the refund amount equals the amount collected for that invoice. Confirm the refund succeeded, not merely that a refund was requested.
Then open the matching Rewardful commission. Check that the affiliate, customer, campaign, and paid invoice line up. Refresh or re-run your report after the integration has processed the refund event.
Remove the commission from the payout batch
If the commission is still Pending, keep it out of the payout file until Rewardful removes or voids it. If it is Due, remove it from the current batch and document the reason.
Do not mark it Paid because it was present in an earlier export. Payout files should use a fresh Due report after refund checks are complete.
Rewardful’s percentage-based commissions use the net sale amount. That figure excludes taxes and refunds, as explained in its promotion code tracking guidance. A full refund leaves no retained sale on that invoice.
Handle refunds after a commission was paid
A refund can arrive after your affiliate payout has already gone out. Rewardful can update the commission record, but it cannot retrieve money from an affiliate’s bank account or payout method.
Apply your written policy. Most teams carry the negative adjustment into the affiliate’s next eligible payout. If the affiliate has no future earnings, record an outstanding balance or write-off decision with an owner.
Do not create a second negative payout without an approved policy. That creates avoidable disputes and may conflict with your payout provider’s controls.
CALCULATE PARTIAL REFUND ADJUSTMENTS CORRECTLY
Partial refunds need more attention because the original sale still exists. The customer keeps part of the product or service. The affiliate should be paid only on the revenue your business retained, subject to the campaign rule.
Rewardful recalculates a commission when Stripe sends a partial invoice refund. Check the revised amount in Rewardful. Then compare it with the cumulative refund amount in Stripe.
Use the total refunded amount, not the latest refund
A customer may receive more than one refund against the same invoice. For example, a $600 invoice may receive a $100 refund on Monday and a second $200 refund two weeks later.
If the campaign pays 25%, the original commission is $150. After $300 in total refunds, net collected revenue is $300. The correct commission is $75. The total reduction is $75, not $50.
Pull the complete refund history from Stripe. Do not use only the most recent refund row.
Check campaign rules before making manual changes
Percentage commissions normally scale with the retained payment amount. Fixed-bounty campaigns can have different conditions. A fixed reward may depend on a successful first payment, a paid month, or another campaign rule.
Do not force a percentage formula onto a fixed commission. Review the campaign configuration and the Rewardful result first. If the result conflicts with your written program terms, place the record in an exception queue.
RUN A PAYOUT CHECKLIST BEFORE MARKING COMMISSIONS PAID
Run this review on a fixed schedule. Weekly works for many SaaS teams. Run an additional check before every monthly payout.
Use the same cutoff date in Stripe, Rewardful, and your payout file.
- Export the Due commissions report and save it with the payout date.
- Match every commission to a Stripe customer and paid invoice.
- Check Stripe for full refunds, partial refunds, credits, failed payments, and disputes.
- Compare each refunded invoice with the updated Rewardful commission amount.
- Confirm the commission passed your configured Pending period.
- Review affiliate eligibility, minimum payout thresholds, and payment details.
- Remove voided, disputed, duplicate, and internal-purchase records.
- Compare the approved total with the payout file before marking any commission Paid.
- Save the reviewer name, evidence location, payout reference, and final decision.
The key operating metric is accepted payouts, not commissions created. A high commission count has no value if finance spends hours repairing payment errors later.
PREVENT OVERPAYMENT WITH HOLD PERIODS AND EXCEPTION RULES
Your Pending period is your first control. If your product allows refunds for 30 days, holding commissions for fewer than 30 days creates a predictable overpayment risk.
Set the hold period based on the longest normal refund window. Add extra review time if invoices are large, contracts include discretionary refunds, or affiliates drive high volumes of trial conversions.
Review high-risk records before they reach Due
Flag records with short-lived subscriptions, repeated refunds, unusually high conversion rates, related customer details, or self-referral signals. Also flag payments with unusual discounts or account credits.
A discount affects the amount your customer paid. Commission should follow actual collected revenue under the campaign rule, not the public list price. The same rule applies when an account credit reduces the invoice total.
Keep affiliate terms clear. State the commission basis, hold period, recurring-payment limit, refund treatment, and the process for negative adjustments. Affiliates can price those rules into their work when the rules are written down.
Keep a last trusted payout report
Save a locked report immediately before each payout batch. If a checkout change, webhook issue, or campaign edit produces missing attribution, stop automatic approvals.
Reconcile a small sample against Stripe first. Check the affiliate, customer, invoice, commission, and refund status. Resume the payout process only after those records match.
TROUBLESHOOT REFUND AND COMMISSION MISMATCHES
Most problems are traceable. The faster you identify the missing link, the less manual cleanup you create.
Stripe shows a refund but Rewardful has no adjustment
First, confirm that the refund applies to the same invoice or payment that created the commission. A refund on a different renewal invoice will not change the original commission.
Next, confirm the Rewardful commission exists and the Stripe connection is active. Allow time for the refund event to process, then refresh the commission and payout reports. Keep the Stripe refund ID with the case.
If the mismatch remains, do not manually pay or reverse the commission without evidence. Assign one owner and record the customer ID, invoice ID, refund ID, affiliate, campaign, screenshots, and follow-up date.
The commission amount does not match your calculation
Check whether you used gross price instead of collected revenue. Then review taxes, discounts, credits, currency, multiple partial refunds, and the campaign’s percentage or fixed reward rule.
Also check whether the refund is pending. A pending refund is not the same as a completed refund. Stripe’s refund API reference uses a refund object with its own status and identifiers, which makes it useful for your internal evidence file.
Do not treat a missing referral as a refund issue. Missing attribution needs its own investigation. Review the tracking path, customer record, campaign rules, and source evidence before you create any manual commission.
FINAL PAYOUT CONTROL
Rewardful affiliate refunds stay accurate when Stripe confirms the money movement and Rewardful confirms the related commission adjustment. Both checks are required.
Hold commissions through the refund window. Preserve the original record. Store every adjustment separately. Then pay only the commissions that still match retained customer revenue.
A payout is ready when finance can trace it to a valid affiliate, a paid invoice, and the final refund status.
