Offer SDK documentation

A self-hosted API, dashboard and React SDK for plans, entitlements and offers. Integrate once, then change what any account can do from the dashboard, with no deploy.

Most apps hardcode pricing: a plan name checked in a dozen places, a trial extended by editing a row, a partner discount handled with an if statement. Offer SDK moves those decisions into records you edit in a dashboard. Your app asks one question, “what can this account do?”, and gets back one answer that already includes the plan, any add-ons, the offer it bought through and any incentive on top.

The three parts

Offer API
A Hono service on Bun with Postgres. It stores every app, account, plan and offer, resolves access, prices checkouts through PayPal and sends signed webhooks.
Dashboard
A Next.js app (offer-app) where your team edits the catalog, builds offers and cancel flows, reads analytics, manages keys and webhooks, and chats with an agent that can make changes for you.
React SDK
Providers and hooks that read an account's access in your app, plus headless components for a checkout page and a cancel flow that you style like the rest of your product.

How it fits together

You deploy all of it yourself: the API, the dashboard, a Render Workflows service and a Postgres database, from one Blueprint. Your app talks to the API with app keys; the dashboard talks to it with a shared admin key.

Your app
React SDK in the browser, your server with the secret key
Dashboard
offer-app (Next.js). Its BFF calls the API as admin
Render Workflows
offersdk-workflows: subscription pauses
Offer API
offersdk-api (Hono on Bun). Holds every record, signs webhooks, prices checkouts
Postgres
offersdk-db
PayPal
Orders, subscriptions, webhooks
AI model
Dynamic save offers
Webhooks
Your endpoints and Zapier
The dashboard also calls the AI model directly for its agent chat, and proxies sign-in to the API so session cookies stay on its own domain.

Built for the PayPal AI Hackathon

Offer SDK is an entry in the PayPal AI Hackathon. PayPal handles every payment, Render hosts the stack and runs pauses as Workflows, Zapier carries webhooks to other apps, and Postman has a request for every API route. How sponsors are used covers each one, and AI features covers where AI picks save offers and runs the dashboard agent.

Deploy

Deploy on RenderShip the API, dashboard, workflows and database from one Blueprint.Environment variablesEvery variable each service reads, and which ones you set.

Sponsors

How sponsors are usedWhere each hackathon sponsor sits in the product.PayPalCheckout, subscriptions, plan changes and webhooks.RenderThe Blueprint, private networking and Workflows for pauses.ZapierSend Offer events to other apps without writing code.PostmanA collection for every API route, with a runnable quickstart.

React SDK

Access and entitlementsRead what an account can use and gate features.CheckoutBuild one checkout page for every offer.Cancel flowsAsk why, offer a save, and cancel or pause in PayPal.

API

AuthenticationBase URL, keys, account tokens and errors.Endpoint referenceEvery route, grouped by resource.WebhooksEvents, signatures and retries.MCP serverConnect AI assistants and coding agents with OAuth or a key.

Dashboard

Dashboard tourWorkspaces, apps and where everything lives.CatalogPlans, entitlements, add-ons and incentives.OffersBuild offers, preview checkout and share links.Cancel flowsSteps, questions and save offers, with a live preview.Agent and MCPChange the catalog by chatting, and manage the app's MCP server.Keys and webhooksAPI keys, webhook endpoints and delivery logs.