MentionFox
MentionFox + Stripe

Use MentionFox with Stripe

MentionFox is a B2B intelligence suite that monitors 52+ platforms for mentions, enriches leads, measures AI visibility, researches investors, and automates outreach—all requiring credits to power searches and campaigns. Stripe handles subscription billing and one-time purchases, while webhooks connect payment events to your MentionFox account so credits are added automatically when transactions succeed.

How it works

1
1. Set Up Your Stripe Account & MentionFox Workspace

Create or log into your Stripe account and enable the Restricted API key with permissions for 'read' on Events and Charges. In MentionFox, navigate to Settings > Billing > Stripe Integration and generate your workspace API token. You'll need this token to authenticate webhook events from Stripe. Save both credentials securely; you'll reference them in the webhook configuration step.

2
2. Configure Webhook Endpoints in Stripe

In your Stripe Dashboard, go to Developers > Webhooks and click 'Add endpoint.' Specify your MentionFox webhook URL (provided in the integration settings) and select the events you want to monitor: 'charge.succeeded' for successful payments, 'charge.failed' for declined charges, and 'customer.subscription.updated' for plan changes. Stripe will send POST requests to your endpoint each time these events occur, allowing MentionFox to synchronize billing data in real time.

3
3. Map Credits to Stripe Plans & One-Time Purchases

In MentionFox Settings > Billing, define how many credits each Stripe price corresponds to. For example, map your Stripe 'Pro Monthly' product to 100 monthly credits (which reset each month), and your 'Starter Credit Pack' to 50 one-time credits (which roll over forever). When a webhook fires indicating a successful payment, MentionFox reads the Stripe price ID, looks up the credit allocation, and deposits credits into the customer's account instantly.

What you can do

Scenario A: Monthly Pro Subscription

A user subscribes to MentionFox Pro ($99/month) via your Stripe checkout. Stripe creates a recurring invoice and charges their card. On successful charge, Stripe fires 'charge.succeeded' to your webhook. MentionFox verifies the payment, recognizes the Pro tier, and adds 100 monthly credits to the account. The customer can immediately use those credits for social listening across Reddit, X, LinkedIn, Quora, and 47 other platforms. Next month, credits reset to 100 again; the subscription renews automatically.

Scenario B: One-Time Credit Pack Purchase

A user runs out of credits mid-campaign while running investor research. They buy the 'Best Value' credit pack (500 credits for $200) through Stripe. The charge succeeds, the webhook fires, and MentionFox instantly adds 500 credits to their account—no monthly reset. These credits persist until used. The user resumes their investor database search and candidate vetting outreach without interruption.

Scenario C: Upgrade from Pro to Agency

A Pro subscriber ($99/mo, 100 credits) decides to upgrade to Agency ($499/mo, 1,000 credits) and invite 4 team members. The old subscription is cancelled and a new one created in Stripe. The 'customer.subscription.updated' webhook notifies MentionFox of the tier change. MentionFox updates the account: monthly credit allowance jumps to 1,000, and 4 additional team seats become available for Outreach Automation campaigns and collaborative lead enrichment work.

How to connect

  1. Step 1: Generate Your API Credentials. Log into MentionFox and visit Settings > Billing & Integrations. Click 'Connect Stripe' and copy your workspace API token. In Stripe, create a new Restricted API key with 'read' permissions on Events and Charges. Keep both tokens in a secure password manager—never commit them to public repositories.
  2. Step 2: Register Your Webhook Endpoint. In Stripe Dashboard > Developers > Webhooks, click 'Add endpoint.' Enter the webhook URL shown in MentionFox Settings > Billing > Stripe Integration. Select events: 'charge.succeeded', 'charge.failed', 'customer.subscription.updated', 'customer.subscription.deleted'. Copy the webhook signing secret and paste it into MentionFox Settings > Stripe Integration > Webhook Secret. Stripe will test the endpoint and confirm it is active.
  3. Step 3: Map Your Stripe Products to Credit Tiers. In MentionFox Settings > Billing > Stripe Product Mapping, list each Stripe price ID alongside its corresponding credit allocation. Examples: Stripe Price ID 'price_pro_monthly' maps to 100 monthly credits; 'price_starter_pack' maps to 50 one-time credits; 'price_agency_monthly' maps to 1,000 monthly credits. Save the mapping. MentionFox will reference this table every time a webhook arrives to determine credit grants.
  4. Step 4: Test & Monitor. Use Stripe's webhook test tool (in Developers > Events) to send a sample 'charge.succeeded' event to your endpoint. Check MentionFox Settings > Integrations > Webhook Logs to see the received payload and response. Create a test subscription in Stripe (use a test card like 4242-4242-4242-4242 in test mode) and confirm credits appear in your test MentionFox account within 5 seconds. Once verified, switch Stripe to live mode and re-test with a real (refundable) charge.

Without MentionFox

Without MentionFox integrated with Stripe, you must manually track which customers paid, look up their tier in a spreadsheet, and email your operations team to add credits by hand—a slow, error-prone process that delays customers from using social listening, lead enrichment, investor research, and outreach automation. Failed charges and upgrades create billing disputes and frustrated users unable to launch campaigns.

Questions, answered

Do I need a Stripe account to use MentionFox?

No. MentionFox can be used as a standalone platform if you manage credits manually. However, if you offer MentionFox as a SaaS product to customers or accept payments, integrating Stripe automates billing, reduces operational overhead, and ensures customers receive credits instantly upon payment.

What happens if a Stripe charge fails or is refunded?

When Stripe fires a 'charge.failed' webhook, MentionFox does not grant credits. If a successful charge is later refunded, Stripe sends 'charge.refunded', and you can manually adjust the customer's account in MentionFox Settings > Users. MentionFox does not auto-reverse credits; the adjustment is your responsibility.

How do monthly credits differ from purchased credit packs?

Monthly credits (included with Pro, Agency, and Enterprise tiers) reset to their tier amount on the 1st of each month and do not roll over. Purchased credit packs (e.g., Starter 50 credits for $20, Growth 200 credits for $80, Best Value 500 credits for $200) are one-time purchases that persist until used and never expire. A Pro user has 100 monthly credits plus any purchased packs simultaneously.

Can I track which features consume the most credits?

MentionFox does not publish a per-feature credit cost matrix publicly. Contact the founder Saul Fleischman via the support form in your workspace for detailed credit allocation by module (social listening across 52+ platforms, AI-visibility measurement, investor research, candidate vetting, outreach automation). Usage logs are available in your MentionFox dashboard under Account > Usage History.

Does MentionFox offer SLAs or guaranteed uptime?

No. MentionFox is a solo founder operation and does not publish SLAs. Paid tier customers receive priority support, but there are no uptime guarantees or service credits. Outages and maintenance are communicated via email to registered accounts.

Ready to connect Stripe?

Start free. See the plans that fit your team.

See pricing