Getting Paid

Payout Process

Once your approved commissions reach the payout threshold, the merchant can create a payout in AgentRef, send the money externally, and mark the payout status as it progresses. Today this is a manual merchant workflow. AgentRef tracks payout state and payout details, but does not automatically send affiliate funds.

How It Works

Commissions accumulate

As your referrals convert, commissions move from pending → approved.

Threshold reached

When your approved balance reaches the program’s payout threshold (default: $50), you become payout-eligible.

Payout processed

The merchant creates a payout record, sends the money outside AgentRef (for example via PayPal or bank transfer), and records the status in AgentRef.

Money arrives

Once the merchant marks the payout as completed, it appears in your payout history. Arrival time depends on the external payment provider.

Setting Your Payout Details

To receive payouts smoothly, add your payout details in AgentRef:

Go to Settings → Payouts in your affiliate dashboard
Choose your payout method: paypal or bank_transfer
Enter the required payout details
Save the profile so merchants can pay you correctly

Merchants may hold payouts until your payout details are complete. Add them before your first payout becomes due.

Payout Schedule

Setting	Default
Payout threshold	$50 USD
Processing time	Merchant-defined
Payment method	PayPal or bank transfer

The merchant can configure the payout threshold per program.

Viewing Payout History

Dashboard

Your dashboard shows all payouts with status, amount, and date.

Via API

Use GET /me/payout-info to check the payout method on file and GET /me/payouts to review payout history.

const headers = {
  Authorization: 'Bearer ak_aff_YOUR_KEY',
};

const payoutInfo = await fetch('https://www.agentref.co/api/v1/me/payout-info', { headers }).then((r) => r.json());
const payouts = await fetch('https://www.agentref.co/api/v1/me/payouts', { headers }).then((r) => r.json());

import httpx

headers = {"Authorization": "Bearer ak_aff_YOUR_KEY"}

payout_info = httpx.get("https://www.agentref.co/api/v1/me/payout-info", headers=headers).json()
payouts = httpx.get("https://www.agentref.co/api/v1/me/payouts", headers=headers).json()

curl "https://www.agentref.co/api/v1/me/payout-info" \
  -H "Authorization: Bearer ak_aff_YOUR_KEY"

curl "https://www.agentref.co/api/v1/me/payouts" \
  -H "Authorization: Bearer ak_aff_YOUR_KEY"

Payout Statuses

Status	Meaning
`pending`	Payout created, waiting to be processed
`processing`	Merchant started the external payment step
`completed`	Merchant confirmed the payout as paid
`failed`	External payment attempt failed and can be retried

Common Issues

My payout failed

The most common reasons are incomplete payout details or a failed external payment attempt. Go to Settings → Payouts and confirm your PayPal or bank transfer details are correct.

I haven't received a payout yet

Check if your approved balance has reached the payout threshold. Also confirm your payout profile is complete and ask the merchant which payout cadence they use.

A commission was deducted from my payout

If a customer requested a refund, the associated commission is reversed. Refunds on already-paid commissions are deducted from your next payout.

Getting Started

Merchant Guide

Agent Integration

Tracking

Integration Guides

Webhooks

For Affiliates

Resources

Payout Process

How It Works

Setting Your Payout Details

Payout Schedule

Viewing Payout History

Dashboard

Via API

Payout Statuses

Common Issues

​Payout Process

​How It Works

​Setting Your Payout Details

​Payout Schedule

​Viewing Payout History

​Dashboard

​Via API

​Payout Statuses

​Common Issues

Payout Process

How It Works

Setting Your Payout Details

Payout Schedule

Viewing Payout History

Dashboard

Via API

Payout Statuses

Common Issues