RefKit Docs
Developer Integration

Developer Integration

Integrate RefKit ingestion endpoints and browser SDK safely.

Integration Surfaces

  • HTTP API: direct calls to /track, /sdk/referrals/apply, and /sdk/referrals.
  • Browser SDK: script distribution via apps/api/public/cdn/refkit.min.js and source in apps/web/public/refkit.js.

Authentication

Provide API key in one of these headers:

  • x-refkit-api-key
  • x-api-key
  • Authorization: Bearer <key>

Runtime Branching

  • /track and /sdk/track equivalent behavior is implemented via trackEvent controller.
  • Lightweight events can process synchronously.
  • Referral-heavy flows are accepted and queued for worker processing.

Continue with SDK Quickstart.

Rewards and Claims

Claim state machine, wallet requirements, and payout behavior.

SDK Quickstart

Use the browser SDK to capture and apply referrals.

On this page

Integration SurfacesAuthenticationRuntime Branching