Docs · FAQ
Frequently asked questions
General
- Do I need a Raws.dev account to receive ambassador payouts?
- Yes — you need an account on Raws.dev to be an active ambassador and to receive any payout via Stripe Connect.
- Can I be an ambassador for multiple projects at the same time?
- Yes — every project keeps its own ambassador list, missions, payouts. Your cross-project totals show on /my/ambassadors.
- Where do I find the ambassador hub for a project?
/p/<slug>/ambassadors— only visible to the owner and active ambassadors. Owners see invite + moderation tools, ambassadors see their referral URL and stats.- What's the public ambassador board?
/p/<slug>/ambassadors-board— public-facing leaderboard ranked by visits driven, with the project's payout transparency metrics. Anyone can view.- Is there an API?
- For now, only the conversion endpoint (
GET /c/<token>) is documented and stable. Other endpoints exist but aren't promised stable yet — contact us if you want early access for a real use case.
Money & payouts
- How fast are ambassador payouts?
- Stripe Connect transfer fires the moment the source event succeeds (tip lands, conversion fires). The funds appear on the ambassador's Stripe balance immediately, payout schedule depends on their Connect settings.
- What if the ambassador hasn't onboarded Stripe Connect?
- The commission row stays in
pending. As soon as they finish Connect onboarding (account.updated → enabledwebhook), every pending row settles automatically. - Can I have different payouts for different ambassadors?
- Not at the moment — the per-signup amount and tip commission tier are per-project. If you need tiered payouts, run separate projects and route referrals accordingly.
- Can I clawback a payout I disagree with?
- Within 7 days of the fire, dispute the conversion from the project hub. Stripe transfer is reversed and the wallet is credited back. Tip refunds also auto-reverse the commission.
- Does Raws.dev take a fee?
- A small platform fee on tip checkouts and on wallet top-ups (shown at checkout). Stripe Connect transfers to ambassadors are full-amount.
Trust & abuse
- What if a builder doesn't fire conversions despite getting traffic?
- We can't run code on their server, so we can't force the fire. What we do: surface conversion rate publicly on the ambassador board (
/p/<slug>/ambassadors-board) and on the application landing. ≥100 ambassador visits in 30 days with zero conversions reported = red warning shown to every prospective ambassador. Vote with your time. - Can someone fire fake conversions to drain a builder's wallet?
- Each fire is rate-limited 60/min per (token, IP). Dedupe is enforced on (project, external_id) — same id can never pay twice. Suspicious abuse: regenerate the project token from the hub to invalidate the leaked embed.
- Can ambassadors self-refer?
- No — the system explicitly skips commission and conversion when the referrer's user id matches the project owner's id, even if a stale cookie tries to trick attribution.
- Can a banned ambassador re-apply?
- Bans block re-application from the same account on the same project. The owner can lift a ban anytime.
Privacy
- What does Raws.dev store about my SaaS visitors?
- Per fire:
external_id(your identifier — keep it non-PII), source IP (truncated), user agent (truncated), timestamp, ambassador handle. Used for fraud review during the 7-day dispute window. See the Privacy & GDPR section for full detail. - Are there third-party cookies?
- No. The tracking tag uses
localStorageexclusively — only the ambassador handle, 30-day TTL. - Do I need a DPA?
- For EU integrations, yes. Email info@raws.dev with your project handle — we'll send the template.