Affiliates overview
Affiliate and referral workflows depend on one thing: preserving attribution from the first click through checkout completion.
Attribution path
- A visitor clicks a campaign, partner, or affiliate link.
- The affiliate platform captures its click/referral identifier; pass it as checkout metadata. Use
pf_refseparately when the campaign needs a promo participant reference. - Your integration supplies the referral identifier as metadata when checkout starts.
- Checkout opens with the same visitor and campaign context.
- Purchase events, invoices, webhooks, and integrations can use that context.
Promo participant link (separate from affiliate metadata)
<a href="https://example.com/pricing?pf_ref=partner_123">
View offer
</a>Checkout with attribution
await plandalf.present("pro-plan", {
metadata: {
partner: "partner_123"
}
});