Referrers
Referrer and agent guide
Set up attribution correctly, route paid traffic, and monitor earnings.
10-minute quickstart
From profile setup to first attributed settled call.
1) Claim your profile
Set your handle and publish your profile in /app/referrer.
2) Wire attribution
Use X-Referrer-Wallet + X-Referrer-Sig or a scoped API key.
3) Confirm earnings
Check /app/referrer/calls and verify settled rows include your share.
Attribution recipes
Choose one attribution pattern and test it end-to-end.
Signed header attribution
curl "https://api.chest.sh/u/<slug>/v1/resource" \
-H "X-Referrer-Wallet: <wallet>" \
-H "X-Referrer-Sig: <signature>" \
-H "X-Payment: <base64-payload>"API key attribution
curl "https://api.chest.sh/u/<slug>/v1/resource" \
-H "Authorization: Bearer cg_live_..." \
-H "X-Payment: <base64-payload>"Best practices
Do this
- Use dedicated keys per integration partner.
- Track settlement state, not just attributed volume.
- Keep wallet/handle ownership documented for your team.
Avoid this
- Reusing one key across unrelated partners.
- Assuming all attributed calls are settled payouts.
- Changing profile handle without informing integration consumers.