# Cashback Hive

> Cashback SDK documentation for publishers. Add cashback offers, member sign-in and tracked affiliate links to any website with one script tag.

- [Cashback SDK](https://developer.cashbackhive.com/index.md): Add cashback offers, member sign-in and tracked affiliate links to your website with the Cashback Hive SDK — a 10 KB script tag for publishers.
- [Quickstart](https://developer.cashbackhive.com/quickstart.md): Install the Cashback Hive SDK in five minutes: add the script tag with your publishable key, wait for cbh:ready, and render your first cashback offers.
- [Keys and allowed origins](https://developer.cashbackhive.com/concepts/keys-and-origins.md): Learn how Cashback Hive publishable keys and allowed origins work, why they are safe to ship in the browser, and which credentials to keep server-side.
- [Lifecycle and readiness](https://developer.cashbackhive.com/concepts/lifecycle.md): Understand how the Cashback Hive SDK initialises, the three ways to detect when it is ready, and how to avoid race conditions in your integration.
- [Plain HTML](https://developer.cashbackhive.com/installation/html.md): Install the Cashback Hive SDK on a static or server-rendered HTML site with a single script tag, then call the API once the cbh:ready event fires.
- [Next.js](https://developer.cashbackhive.com/installation/nextjs.md): Install the Cashback Hive SDK in a Next.js App Router project using next/script, with a typed useCashbackHive hook that waits for the SDK to be ready.
- [React (Vite, CRA, Remix)](https://developer.cashbackhive.com/installation/react.md): Install the Cashback Hive SDK in a React single-page app built with Vite, Create React App or Remix, and wait for readiness with a small custom hook.
- [Google Tag Manager](https://developer.cashbackhive.com/installation/gtm.md): Load the Cashback Hive SDK through a Google Tag Manager Custom HTML tag when you cannot edit the site source, including a copy-paste tag and trigger setup.
- [Widgets overview](https://developer.cashbackhive.com/widgets/overview.md): Learn what Cashback Hive SDK widgets are, how the Offers and Activate widgets are enabled per property, and how the reference implementations are built.
- [Offers widget](https://developer.cashbackhive.com/widgets/offers.md): Build a cashback offers widget with the Cashback Hive SDK: list, search and paginate offers, show logos and rates, and link out through tracked URLs.
- [Activate widget](https://developer.cashbackhive.com/widgets/activate.md): Build an Activate widget with the Cashback Hive SDK so visitors can sign in as members, earn cashback on purchases, and see their pending and paid balances.
- [Members and authentication](https://developer.cashbackhive.com/guides/members-and-auth.md): Learn how Cashback Hive member sign-in works end to end: the popup flow, where the session token is stored, and how to react to auth:change events.
- [Click tracking](https://developer.cashbackhive.com/guides/click-tracking.md): Learn how Cashback Hive tracked links attribute purchases to your property, and how to attach your own click IDs, sub-IDs and retailer deep links.
- [Local development](https://developer.cashbackhive.com/guides/local-development.md): Develop against the Cashback Hive SDK on localhost with real offer data, or switch to mock mode for offline work, demos and automated tests.
- [Content Security Policy](https://developer.cashbackhive.com/guides/content-security-policy.md): Configure Content Security Policy for the Cashback Hive SDK: the script-src, connect-src and img-src directives it needs and what each one is for.
- [Troubleshooting](https://developer.cashbackhive.com/guides/troubleshooting.md): Fix common Cashback Hive SDK integration problems: the script not initialising, 403 origin errors, blocked sign-in popups, empty offers and CSP issues.
- [Configuration](https://developer.cashbackhive.com/reference/configuration.md): Cashback Hive SDK configuration reference: every script tag data attribute, the manual init() options, and the instance properties on window.CashbackHive.
- [Offers](https://developer.cashbackhive.com/reference/offers.md): Cashback Hive SDK offers API reference: list, search and paginate cashback offers with offers.list(), or fetch a single offer by slug with offers.get().
- [Member](https://developer.cashbackhive.com/reference/member.md): Cashback Hive SDK member API reference: read the signed-in member's profile, cashback balances and recent activity with member.current() and member.activity().
- [Auth](https://developer.cashbackhive.com/reference/auth.md): Cashback Hive SDK auth API reference: check sign-in state and sign members in or out with auth.isSignedIn(), auth.signIn() and auth.signOut().
- [Tracking](https://developer.cashbackhive.com/reference/tracking.md): Cashback Hive SDK tracking API reference: build tracked retailer URLs with trackingUrl() and open them with openOffer(), including click IDs and sub-IDs.
- [Events](https://developer.cashbackhive.com/reference/events.md): Cashback Hive SDK events reference: subscribe to ready, click and auth:change with on() and off(), and listen for the window-level cbh:ready event.
- [Types](https://developer.cashbackhive.com/reference/types.md): Cashback Hive SDK TypeScript reference: the Offer, Member and ActivityItem data shapes, plus a ready-to-use declaration file for window.CashbackHive.
- [Errors](https://developer.cashbackhive.com/reference/errors.md): Cashback Hive SDK error reference: the errors the SDK throws and rejects with, including SdkApiError status codes, and how to handle each one.
- [Changelog](https://developer.cashbackhive.com/changelog.md): Release notes for the Cashback Hive SDK: new features, fixes and breaking changes in each version of the publisher JavaScript SDK.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.