Stripe Payment Gateway

Stripe is a leading payment processor that allows businesses to securely accept payments online. With Fudli, you can connect your Stripe account to start receiving payments directly from your customers.

This guide walks you through connecting your Stripe account and configuring the required API keys and Webhook secrets.

Step 1: Open Payment Gateway Settings in Fudli

1. Log in to your Fudli Admin Panel.
2. Navigate to Settings > Payment Gateways.
3. Click on Manage under Stripe.
4. Toggle the Enable Stripe option.

Step 2: Enable Test Mode (Optional but Recommended)

When you’re first setting up Stripe, enable Test Mode to safely test checkout flows using Stripe’s test cards.

• Test publishable key
• Test secret key
• Test webhook secret

Step 3: Get Your Stripe API Keys

1. Log into your Stripe account: https://dashboard.stripe.com
2. Go to Developers > API keys or visit API Keys page

You’ll find:

• Publishable key → for the frontend (public).
• Secret key → for your backend (private).

👉 Copy these values into the Test Mode or Live Mode fields inside Fudli.

Step 4: Set Up Webhooks

Stripe needs a Webhook endpoint to send payment events (e.g., successful payment, refund).

1. In Stripe Dashboard, go to Webhook creation page (Test Mode) and Webhook creation page (Live Mode)

   (Switch “test” to “live” in the URL for live mode).

2. Select Your account.
3. Tick Select all events.
4. Click Continue.
5. Enter your Webhook endpoint URL (e.g. https://order.example.com/stripe-callback).
6. Click Add endpoint.

Step 5: Copy the Webhook Signing Secret

After creating the webhook:

• Stripe shows a Signing secret (e.g., whsec_12345...).
• Copy this and paste it into the Test Webhook Secret (for test mode) or Live Webhook Secret (for live mode) in Fudli.

⚠️ This is different from API keys.

• API keys → let your server talk to Stripe.
• Webhook secret → lets your server confirm that Stripe’s webhook events are real.

Step 6: Save and Test

1. Save your Stripe settings in Fudli.
2. If you’re in Test Mode, try placing a test order using one of Stripe’s test card numbers.
   • Example: 4242 4242 4242 4242 with any future date + CVC.
3. Check if payments appear under Payments in your Stripe Dashboard.

✅ You’re done! Once everything works in Test Mode, disable Test Mode and repeat the steps with your Live keys and Live Webhook secret.