Skip to main content
A conversion is created every time an affiliate-referred customer completes a purchase. It records the sale amount, the commission owed, and the current status of that commission. Conversions are the backbone of your affiliate program – everything from payouts to fraud detection is tied to them.

​
Conversion lifecycle

pending → approved → paid
           ↓
        refunded
StatusWhat it means
pendingConversion created from a Stripe event. Waiting for review or approval window.
approvedCommission confirmed. Will be included in the next payout.
refundedThe underlying Stripe charge was refunded. Commission is voided.
rejectedManually rejected or flagged as fraudulent. Commission is voided.
Most programs approve conversions automatically. If your program has fraud detection enabled, suspicious conversions may stay in pending until you resolve the associated flag.

​
How conversions are created

AgentRef listens to your connected Stripe account for checkout.session.completed and invoice.payment_succeeded events. When a purchase is traced back to an affiliate click (via cookie or referral code), a conversion is created automatically – no server-side code needed beyond the tracking snippet. The conversion captures:
  • saleAmount – the charged amount in cents
  • currency – from the Stripe charge
  • customerEmail – from the Stripe customer
  • commissionAmount – calculated from your program’s commissionPercent
  • commissionType – one_time or recurring / recurring_limited

​
Viewing conversions in the dashboard

Go to Programs > [Your Program] > Conversions. You can filter by status, date range, or affiliate. Click any row to see the full conversion detail including the originating click and Stripe charge ID.

​
API reference

​
List conversions

Scope: conversions:read 
curl "https://www.agentref.co/api/v1/conversions?status=pending&limit=25" \
  -H "Authorization: Bearer ak_live_YOUR_KEY"
Query parameters
ParameterTypeDescription
programIdUUIDFilter to a specific program
affiliateIdUUIDFilter to a specific affiliate
statusstringpending | approved | rejected | refunded
startDate / fromISO datetimeStart of date range
endDate / toISO datetimeEnd of date range
limitnumberMax results (1–100)
page / offsetnumberPagination

​
Get conversion stats

Returns aggregate metrics for a time period. Scope: stats:read 
curl "https://www.agentref.co/api/v1/conversions/stats?period=30d&programId=PROGRAM_ID" \
  -H "Authorization: Bearer ak_live_YOUR_KEY"
Period options: 7d, 30d, 90d, all

​
Get recent conversions

Returns the most recent conversions (up to 20). Useful for dashboard widgets and webhooks verification. Scope: conversions:read 
curl "https://www.agentref.co/api/v1/conversions/recent?limit=5" \
  -H "Authorization: Bearer ak_live_YOUR_KEY"

​
What’s next

Payouts & Billing

Learn how approved conversions become payouts to your affiliates.

Fraud Detection

See how AgentRef flags suspicious conversions before they’re approved.