Skip to main content

​
How Payouts Work

When affiliates earn commissions, the money flows through a simple lifecycle: 
Conversion Created → Commission Pending → Payout Created → Payout Processing → Payout Completed

​
Payout Lifecycle

StatusDescription
pendingCommission earned, waiting to reach payout threshold
processingMerchant has started the external payment step
completedMerchant marked the payout as paid
failedExternal payment attempt failed and can be retried

​
Payout Thresholds

Affiliates become payout-eligible when approved commissions reach the threshold. You then create the manual payout record in AgentRef. Default threshold: $50 USD. Configurable per program.

​
Manual payout workflow

This is the active launch contract for payouts today. Affiliates save payout details in AgentRef using PayPal or bank transfer fields. Merchants then:
  1. Create a payout record in AgentRef
  2. Export or prepare the payout externally
  3. Send the payment outside AgentRef
  4. Mark the payout as processing, completed, or failed
AgentRef tracks the payout state and audit trail, but does not move money on the merchant’s behalf.

​
Managing Payouts via API

​
List Payouts

const payouts = await client.payouts.list({
  programId: 'prg_abc123',
  status: 'pending',
})

​
Payout Statistics

const stats = await client.payouts.stats({
  programId: 'prg_abc123',
})
// { totalPaid, totalPending, totalFailed, count }

​
AgentRef Billing

AgentRef uses usage-based billing – you only pay when you earn.

​
How It Works

  • $0 to start – no upfront cost, no credit card required
  • You pay based on tracked conversions, not seats or features
  • Scales with your success – costs grow only as revenue grows

​
Billing API

// View current billing status
const billing = await client.billing.get()

// View available tiers
const tiers = await client.billing.tiers()
Billing is handled automatically through Stripe. You can view your usage and invoices in the AgentRef dashboard under Settings → Billing.