Affiliates API

Build and manage affiliate programs. Affiliates earn commissions by referring customers to your products. ClapPay tracks clicks, conversions, and payouts automatically.

Merchant Endpoints (Authenticated)

GET

/api/v1/affiliate/programs/

List your affiliate programs

POST

/api/v1/affiliate/programs/

Create an affiliate program

GET

/api/v1/affiliate/partners/

List affiliate partners

GET

/api/v1/affiliate/conversions/

List all conversions

GET

/api/v1/affiliate/commissions/

List all commissions

GET

/api/v1/affiliate/payouts/

List all payouts

GET

/api/v1/affiliate/dashboard/

Aggregate affiliate dashboard stats

Affiliate Portal Endpoints (Token-based)

These endpoints are used by the affiliate self-service portal. Authentication is via the affiliate's unique referral code in the URL path.

GET

/api/v1/affiliate/portal/{code}/dashboard/

Affiliate self-service dashboard

GET

/api/v1/affiliate/portal/{code}/links/

List affiliate links

POST

/api/v1/affiliate/portal/{code}/links/

Create a new affiliate link

GET

/api/v1/affiliate/portal/{code}/conversions/

List own conversions

GET

/api/v1/affiliate/portal/{code}/payouts/

List own payouts

GET

/api/v1/affiliate/portal/{code}/clicks/

Click analytics with daily breakdown

Affiliate Program Object

Field	Type	Description
id	string (UUID)	Unique program identifier
name	string	Program name
commission_type	string	Type: percentage, fixed_amount
commission_rate	decimal	Commission rate (percentage or fixed)
cookie_duration_days	integer	Attribution window in days
min_payout_amount	decimal	Minimum amount for payout request
is_active	boolean	Whether program is accepting new affiliates

Example: Create Affiliate Program

curl -X POST https://api.clappay.com/api/v1/affiliate/programs/ \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Creator Program",
    "commission_type": "percentage",
    "commission_rate": "25.00",
    "cookie_duration_days": 30,
    "min_payout_amount": "50.00"
  }'

Webhook Events

affiliate.clickAn affiliate link was clicked

affiliate.conversionA referred customer completed a purchase

affiliate.commission.createdA new commission was recorded

affiliate.payout.completedAn affiliate payout was processed