5 minute setup

Quick-Start Guide

Go from zero to real-time Stripe payment monitoring in three steps. Connect your account, configure alerts, and share your status page.

In this guide

Prerequisites

A Stripe account with API access (test mode works too)
A Faultly account — sign up at faultly.nanocorp.app
(Optional) A Discord or Slack workspace for alerts

Create a project & connect Stripe

Link your Stripe webhooks to start monitoring payments

1aCreate a new project in Faultly

Go to your Dashboard and click Add Project. Enter a name for your project (e.g., “My SaaS Production”) — a URL-safe slug will be auto-generated.

Screenshot: Project creation — name & slug

1bCopy your Faultly webhook endpoint

After creating your project, Faultly generates a unique webhook endpoint URL. Copy this — you'll paste it into Stripe in the next step.

Your Faultly Webhook Endpoint

https://faultly.nanocorp.app/api/webhooks/stripe?projectId=YOUR_PROJECT_ID

1cAdd the webhook in your Stripe Dashboard

Go to Stripe Dashboard → Developers → Webhooks and click “Add endpoint”. Paste your Faultly webhook URL. Under events, select:

Stripe Events to Subscribe

charge.failed
payment_intent.payment_failed
invoice.payment_failed
checkout.session.expired

Screenshot: Stripe webhook configuration

1dPaste the Stripe signing secret into Faultly

After creating the webhook in Stripe, click “Reveal” under the signing secret. Copy the whsec_... value and paste it in your Faultly project setup (Step 3 of project creation).

Screenshot: Pasting webhook secret in Faultly

Security note: Faultly uses this signing secret to verify that incoming webhooks are genuinely from Stripe using HMAC-SHA256 signature verification. Your secret is encrypted at rest.

✓Verify the connection

Once connected, go back to Stripe and click “Send test webhook”. You should see the event appear on your Faultly dashboard within seconds. If it doesn't, double-check that the signing secret matches and the endpoint URL is correct.

Troubleshooting: If events aren't appearing, make sure your Stripe webhook is configured for the correct events (charge.failed, etc.) and is in “Active” status. Check the Stripe webhook logs for delivery errors.

Configure Discord or Slack alerts

Get notified instantly when payment failures occur

DiscordSet up Discord webhook

In your Discord server, go to Server Settings → Integrations → Webhooks → New Webhook. Name it “Faultly Alerts”, choose a channel (e.g., #alerts-payments), and copy the webhook URL.

Screenshot: Discord webhook creation

SlackSet up Slack webhook

Create an Incoming Webhook in Slack: go to api.slack.com/apps → Create New App → Incoming Webhooks. Activate webhooks, add a new webhook to your workspace, and select your alerts channel.

Screenshot: Slack webhook configuration

2cAdd the webhook URL to your Faultly project

Go to Dashboard → Your Project → Settings. Paste your Discord or Slack webhook URL and select the notification channel type. Click Save.

Screenshot: Faultly project settings — webhook URL

Alert format: Faultly sends rich notifications with severity level, event type, customer details, and a direct link to your status page. Discord alerts use embeds, Slack uses Block Kit.

2dEmail alerts (automatic)

Email notifications are enabled by default for all projects. When an incident is detected, you'll receive an HTML email with full incident details at your account email address. You can toggle email alerts in your project settings.

Share your public status page

Give your customers transparency into payment health

3aYour status page is live

Once your project is created, your public status page is automatically available at:

Your Status Page URL

https://faultly.nanocorp.app/status/YOUR-PROJECT-SLUG

Screenshot: Live status page with services and incidents

3bWhere to share your status page

Add a link to your status page in these locations to build customer trust:

Website footer

Add a 'System Status' link

Documentation

Link from your API docs

Support channels

Include in your help center

Email signatures

Add to transactional emails

3cWhat your customers see

Your status page shows real-time information including:

•Current system status (Healthy, Degraded, or Major Outage)
•Individual service health: Payments, Subscriptions, Invoicing, Webhooks
•Active and recent incident timeline with severity levels
•30-day incident summary statistics

Auto-refresh: The status page polls for updates every 30 seconds, so your customers always see the latest status without refreshing.

You're all set!

Faultly is now monitoring your Stripe payments. When a failure occurs, you'll get an alert within seconds and your status page will update automatically.

Free for 14 days — no credit card required. Then $29/mo.

Subscribe — $29/mo Go to Dashboard

Need help?

If you run into any issues during setup, check out these guides for more context:

→Introducing Faultly — what Faultly does and how it works
→How Stripe Payment Failures Cost Real Revenue — why monitoring matters
→Monitor Stripe Payment Failures in Real-Time — technical deep dive
→Stripe Webhook Monitoring Guide — complete webhook reference
→Why Your SaaS Needs a Payment Status Page — status page benefits

You can also reach out to our support team — we typically respond within a few hours.