Settings — Listener Support
Go to Benecaster → Settings → Listener Support to configure how listener donations are collected and displayed on your site.
General
| Setting | Description |
|---|---|
| Enable Listener Support | Turns the feature on site-wide. When off, the floating button and shortcode output are suppressed everywhere. |
| Display style | How the support prompt appears: Floating button (fixed bottom-right), Inline (in the page flow), or After player (below the episode player). |
| Show to | Everyone shows the prompt to all visitors including subscribers. Non-subscribers only hides it from visitors who already have an active subscriber token. |
| Donation link | The URL your button links to — your Ko-fi page, Stripe checkout, PayPal.me, or any other external payment page. |
| Button label | Text on the CTA button. Default: “Support the show”. |
| Message | Optional short prompt displayed above the button. |
Per-show overrides for any of these settings are available from the show’s own settings panel.
Stripe (Stripe Mode)
If you’re using Stripe Mode (direct payment processing), connect your Stripe account here. See Setting Up Listener Support (Stripe Mode) → for the full setup walkthrough.
Webhooks
The Webhooks subsection lets you configure signature verification for non-Stripe donation platforms. When a secret is configured, Benecaster verifies incoming webhook payloads from that platform before logging the donation — protecting your wall from spoofed entries.
Supported platforms and the credential type each requires:
| Platform | Setting label | Where to find your credential |
|---|---|---|
| Ko-fi | Ko-fi verification token | Ko-fi → More → API (Webhook URL page) → Verification Token |
| PayPal | PayPal webhook ID | PayPal Developer Dashboard → My Apps → Webhooks → Webhook ID |
| Buy Me a Coffee | Buy Me a Coffee webhook secret | Buy Me a Coffee → Extras → Webhooks → Secret |
How to configure a platform:
- Retrieve the token or ID from the platform’s developer settings (links above).
- Paste it into the corresponding field in Settings → Listener Support → Webhooks.
- Click Save settings.
If a secret is already saved, the field label shows (saved — leave blank to keep current) and the field loads blank — this is intentional, secrets are never re-displayed. To update a secret, type the new value; to clear it, type only whitespace and save.
See Webhook Signature Verification → for what happens after a secret is configured, how verification failures are logged, and what platforms without a configured secret do.
Donor Data Retention
Controls how long donation records are stored before automatic deletion. See Listener Support Overview → for the data retention defaults.