Should I use the iframe or popup display mode?

Use the iframe mode when you want the offerwall embedded inside a container on your page, such as a rewards section in a web app. Use the popup mode when you want a full-screen experience triggered by a button click. The popup mode is better for mobile web because it gives offers the full viewport.

Can I use the SDK with a bundler like Webpack or Vite?

Yes. The SDK is published on npm as @perkox/web-offerwall with full ESM and CommonJS support. Install it with npm or yarn and import it in your bundle. The script tag method is available for non-bundled sites.

Do I need a backend server, or can I handle everything client-side?

You need a backend server for secure reward crediting. The client-side SDK handles displaying the offerwall and emitting reward events for UX, but the actual crediting must happen via a server-side postback that you verify with an HMAC signature. Crediting based on client-side events alone is insecure.

Does the SDK work across different domains and subdomains?

Yes. The SDK uses postMessage for cross-origin communication between your page and the Perkox offerwall iframe/popup. No special CORS headers are needed on your server. You do need to register your domain(s) in the Perkox dashboard so the SDK accepts postMessage events from your origin.

Is the web SDK free to use?

Yes. The SDK is free to install and use. Perkox operates on a revenue-share model — you earn a percentage of each completed offer. There are no upfront costs, monthly fees, or minimum commitments.

The Web Offerwall JavaScript SDK: Complete Integration Guide (2026)

The Web Offerwall JavaScript SDK: Complete Integration Guide (2026) | Perkox