Failment

Connect Stripe to Failment

Enable real-time payment monitoring, automatic recovery detection, and advanced failed payment analytics.

Prerequisites

  • Active Stripe account with payment processing enabled
  • Admin access to your Stripe Dashboard
  • Active Failment account

Configuration

Follow these steps to connect your Stripe account to Failment for comprehensive payment monitoring and recovery tracking.

Step 1: Create Restricted API Key

Create a secure API key with minimal required permissions for Failment integration.

1
Click this pre-configured link to create your restricted key:
Create Failment API Key
2The key name will be automatically set to "Failment"
3Click "Create restricted key"
4Copy the generated API key (starts with rk_live_ or rk_test_)

Security Note:

This restricted key only has read permissions for payment data and limited write permissions for webhooks. It cannot modify your payments or customers.

Step 2: Configure Webhook Endpoint

Set up your personal webhook endpoint to receive real-time payment events.

Your personal webhook URL:

https://failment.com/api/stripe/webhook/your-email%40example.com
1Go to Stripe Dashboard → Webhooks
2Click "Add endpoint"
3Paste your webhook URL in the "Endpoint URL" field
4
Select these events to listen to:
payment_intent.payment_failed
payment_intent.succeeded
charge.failed
charge.succeeded
invoice.payment_failed
invoice.payment_succeeded
5Click "Add endpoint"

Prefer a video guide?

Watch the setup and follow the step-by-step SOP with screenshots: View guide

Step 3: Get Webhook Secret

Retrieve the webhook signing secret to enable secure communication.

1In your newly created webhook endpoint, click "Click to reveal" under Signing secret
2Copy the webhook signing secret (starts with whsec_)

Webhook Security:

Webhooks are secure and only send data to your configured endpoint. We use webhook signatures to verify the authenticity of each request.

Step 4: Connect to Failment

Location: https://failment.com

In your Failment dashboard:

1Navigate to Settings → Integrations
2Click Connect Stripe
3
Enter your credentials:
  • Stripe API Key (from Step 1)
  • Webhook Secret (from Step 3)
4Click Save Integration

Success! Your Stripe integration is now active.

How Failment's Webhook System Works

Your personal webhook URL and secret enable advanced failed payment recovery features:

  • Secure Authentication: Webhook secrets verify that events are actually from Stripe
  • Personal URL: Each user gets a unique webhook endpoint for better security
  • Real-time Monitoring: Instant notifications when payments fail
  • Automatic Recovery Detection: Tracks when customers retry and succeed within 27 days
  • Multi-channel Alerts: Notifications via Discord, Slack, Teams, and email
  • Customer Communications: Automated email notifications to customers about failed payments

Testing Your Integration

After successful connection, you can test your integration:

1Look for the Test Integration button in your Failment dashboard
2Click it to simulate a webhook event
3Verify that test notifications are received in your configured channels

Troubleshooting

Webhook events not being received?

  • Verify your webhook URL is exactly as shown in Step 2
  • Check that all required events are selected
  • Ensure the webhook secret matches exactly (no extra spaces)

API connection issues?

  • Verify you're using a restricted key, not a publishable key
  • Check that the key has all required permissions
  • Make sure you're using the live key for production data

Still having issues?

Contact our support team at info@failment.com

We'll respond within 24-48 hours with a solution.

Advanced

Multiple Stripe Accounts

If you have multiple Stripe accounts, you'll need to set up separate webhook endpoints for each account using different webhook URLs.

Test vs Live Mode

Make sure to configure both test and live webhooks if you want to monitor payments in both environments. Use the corresponding API keys for each mode.

Disconnect Integration

Settings → Integrations → Stripe → Disconnect