Decline widget
Use this when your app has already decided a user is not a fit (risk, KYC, rules, etc.) and you want to show alternative sponsored offers instead of an empty “no” screen. The same overlay UI as geo-blocking applies; only how it is opened differs: your server must call trigger — the integration secret never goes in the browser.
Install in three steps
1. Dashboard — Open the site → Site details → turn on Decline widget. Confirm your domain is allowed. Copy Publisher key, Website key, and the integration secret (keep the secret on the server only; never in NEXT_PUBLIC_* or client bundles).
2. Your page — Add the widget-decline.js snippet (below) to the page where the declined user lands. Must be the same domain you registered.
3. Your server — The script creates a session id and waits. Send that id to your backend, then call POST /v1/widget-decline/trigger with Authorization: Bearer and { "sessionId": "…" } when you want the overlay. Use the same sessionId the embed created — do not mint a second id with your own fetch.
---
Prerequisites (detail)
1. Site details: Decline widget enabled; domain allowlisted for embeds.
2. Keys: public keys in the HTML snippet; integration secret only in server env / secrets manager.
3. Where to load: any page on that domain after your own “declined” path (dedicated URL, modal step, etc.).
What the embed does
| Step | What happens |
|---|---|
| 1 | On load, the script POSTs to https://api.affilfinder.com/v1/widget-decline/session?pub=…&website=… and receives sessionId and expiresAt. |
| 2 | It exposes sessionId as window.__AFFILFINDER_DECLINE_SESSION_ID and dispatches a browser event affilfinder:decline-session with detail: { sessionId }. |
| 3 | It polls GET …/v1/widget-decline/session/:sessionId?pub=…&website=… until status is ready or the session expires (~15 minutes). |
| 4 | Your server calls POST /v1/widget-decline/trigger with the integration secret and JSON { "sessionId" } when you want to show offers. |
| 5 | After trigger, the embed loads offers and renders the same style of overlay as the geo-blocking widget. |
Script loading: the embed looks up the active