Affiliates & Referrals

Join Markt tracks referrals on orders. There is no dedicated /api/affiliates* CRUD surface — configuration lives on the store and buyer referral data surfaces in customer UI.

Store settings

affiliateEnabled
affiliatePercentage

Configured in the dashboard Affiliate section (saved with store settings).

Capture paths

Source	How
Embed	`?ref=` → cookie `markt_affiliate` → `affiliateCode` on open
Checkout start	`referralCode` body field
Customer portal	GET /api/customer/referrals (customer session)

Stored on the order as referralCode.

Integrator rules

Prefer letting the SDK read ?ref= automatically.
Override with affiliateCode only when you own attribution logic.
Do not invent a public affiliates admin API — use the dashboard until one ships.

See Embed SDK and Start Checkout.

⌘I