Stripe Integration
Connect your Stripe account to AFFY and every payment is automatically tracked, attributed to the right affiliate, and triggers commission calculation — no manual work required.
- Installed the AFFY tracking script on your website — without it, customer clicks can't be linked to Stripe payments
- Created at least one commission flow — AFFY needs a flow to calculate the commission amount when a payment arrives
Connecting your Stripe account
Go to Settings → Integration
Click Connect Stripe
Authorize AFFY
You're connected
How automatic tracking works
Once connected, Stripe sends webhook events to AFFY whenever a payment occurs. AFFY matches the customer to an affiliate click (via the tracking cookie) and creates a commission automatically.
The AFFY tracking script records the click and stores a click_id cookie on the visitor's browser (30-day window).
If you call the registration tracking endpoint, AFFY links the customer account to the affiliate click.
Stripe sends a payment_intent.succeeded (or invoice.payment_succeeded for subscriptions) webhook event to AFFY.
AFFY matches the customer email to the tracked affiliate click and creates a Pending commission using the affiliate's assigned flow.
Review the commission in the Payouts section, approve it, and mark it as paid when you transfer funds to the affiliate.
Supported Stripe events
AFFY processes the following Stripe webhook events automatically. You do not need to configure anything in your Stripe dashboard — the webhook endpoint is registered during the OAuth connection.
| Stripe Event | What AFFY does |
|---|---|
| payment_intent.succeeded | Records a conversion and creates a commission for the attributed affiliate. |
| invoice.payment_succeeded | Tracks recurring subscription payments — each successful invoice can generate a commission. |
| charge.refunded | Marks the related commission as Refunded, removing it from the payout queue. |
| payment_intent.payment_failed | No commission is created. Failed payments are ignored. |
| payment_intent.canceled | No commission is created. Canceled payments are ignored. |
Coupon & discount code tracking
If a customer uses a Stripe coupon or discount code associated with an affiliate, AFFY can attribute the conversion to that affiliate — even without a tracking cookie. Coupon-based attribution is useful for content creators and influencers who share unique discount codes with their audience.
Multi-currency support
If your Stripe account processes payments in multiple currencies, AFFY automatically converts the transaction amount to your base currency when calculating commissions. Conversion rates are applied at the time of the payment event.
How refunds are handled
When a refund is issued in Stripe, AFFY receives the charge.refunded event and automatically marks the related commission as Refunded. The commission is removed from the payout queue and will not be paid out.
Full refund
The entire commission is reversed.
Partial refund
The commission is proportionally reduced based on the refunded amount.
Refund after approval
Commission status changes to Refunded even if it was previously Approved.
Troubleshooting
A payment happened but no commission was created
The customer may not have been attributed to an affiliate. This happens when a customer pays without previously clicking an affiliate link, or the tracking cookie expired (30-day window). You can create a manual commission from the Payouts section.
Commissions show the wrong amount
Check the commission flow assigned to the affiliate. The commission is calculated based on the flow's rate applied to the Stripe payment amount. If the payment was in a foreign currency, verify the currency conversion is set up correctly.
Stripe shows the webhook as failing
Webhook failures are usually temporary (network issues). Stripe retries failed webhooks automatically. If failures persist, reconnect your Stripe account from Settings → Integration.