Developers

15-minute web integration.

Three install paths, from a single script tag to full ad gating around your existing bootstrap. Pick the shallowest one that does what you need.

Never expose the publisher API key in browser code. Publisher tokens are minted by your own server-side endpoint; the browser only ever holds short-lived tokens.

PATH 1

Full SDK — paywall + ad gating

for sites that already run ads

Load /sdk/paywall-ads.js, initialize it, mark your ad slots, then wrap your existing ad bootstrap in gateAds. Readers who paid get the reduced-ads experience their entitlement specifies.

<script src="https://dropcap-admin.pages.dev/sdk/paywall-ads.js"></script>
<script>
  Paywall.init({
    apiBase: "https://your-api.workers.dev",
    getAccessToken: () => readerJwt,           // your reader session
    getPublisherToken: () => fetchPubToken(),  // minted server-side
    contentId: "ARTICLE_ID"
  });

  // mark slots in markup:  <div data-paywall-ad="leaderboard"></div>

  Paywall.gateAds({
    onNoAds:       () => {},                 // skip the bootstrap
    onMinimalAds:  () => bootstrapAds({ cap: 1 }),
    onStandardAds: () => bootstrapAds()
  });
</script>

Google Publisher Tag adapter

Wrap your GPT calls with gateDisplay and gateRefresh.

Prebid adapter

Wrap your auction with gateRequestBids.

PATH 2

One-tag embed

fastest — no site-wide SDK, no publisher token, no token endpoint

<script src="https://dropcap-admin.pages.dev/sdk/paywall-embed.js"
        data-site-key="site_xxx"
        data-api-base="https://your-api.workers.dev"
        data-placement="below_article"
        data-content-id="ARTICLE_ID"></script>

PATH 3

Hosted article

press releases and advertorials on your domain

<div data-paywall-article></div>
<script src="https://dropcap-admin.pages.dev/sdk/paywall-article.js"></script>

The article renders inside your shell, in your sitemap, with the required disclosure label.

Reader consent UI

paywall-consent.js ships a themeable, focus-trapped dialog with ARIA wiring and every string overridable, so consent copy stays yours and your legal team’s.

Native reference verifiers

Verify signed entitlements in your own apps: PaywallAds.swift, PaywallAds.kt and paywall_ads.dart. Ad-free is enforceable here, unlike on the open web.

REST API

Everything the dashboard does, over HTTP — with auto-generated OpenAPI 3.1 specs and Postman collections so your client is a codegen step away.

Signed entitlements

Access and ad-tier decisions are JWS-signed and verifiable against a published JWKS, so your edge worker can decide without a round trip.

Start with one section of the site. Widen what works.

Book a walkthrough Publisher overview