Stripe Integration Setup
Complete guide to configure Stripe payments for GuardSOC
Step 1: Get Your Stripe API Keys
Action Required:
- Go to Stripe API Keys Dashboard
- Log in or create a Stripe account (free)
- Find your Publishable key (starts with
pk_test_) - Click "Reveal test key" to see your Secret key (starts with
sk_test_) - Copy both keys
Example Publishable Key:
pk_test_51ABcDeFgHiJkLmNoPqRsTuVwXyZ123456789Example Secret Key:
sk_test_51ABcDeFgHiJkLmNoPqRsTuVwXyZ123456789Step 2: Configure Stripe Webhook
Action Required:
- Go to Stripe Webhooks Dashboard
- Click "+ Add endpoint"
- Enter the Endpoint URL below
- Select events to listen to (see list below)
- Click "Add endpoint"
- Copy the Signing secret (starts with
whsec_)
Your Webhook Endpoint URL:
https://aiguardsoc.com/api/functions/stripeWebhookSelect these events in Stripe:
customer.subscription.createdcustomer.subscription.updatedcustomer.subscription.deletedinvoice.payment_succeededinvoice.payment_failedcustomer.subscription.trial_will_endcheckout.session.completedExample Webhook Signing Secret:
whsec_ABcDeFgHiJkLmNoPqRsTuVwXyZ123456789Step 3: Add Secrets to Base44 Dashboard
Action Required:
- Go to Base44 Dashboard → Your App → Code → Secrets
- Add the following three secrets:
STRIPE_SECRET_KEYRequiredYour Stripe Secret Key (sk_test_...)
STRIPE_PUBLISHABLE_KEYRequiredYour Stripe Publishable Key (pk_test_...)
STRIPE_WEBHOOK_SECRETRequiredYour Stripe Webhook Signing Secret (whsec_...)
Step 4: Test Your Integration
- Go to Testing Dashboard in the admin menu
- Create a test tenant via Onboarding
- Run the test suite to verify license generation and validation
- Test a payment using Stripe test card:
4242 4242 4242 4242 - Verify webhook is receiving events in Stripe Dashboard
Stripe Test Cards:
- ✓ Success:
4242 4242 4242 4242 - ✗ Declined:
4000 0000 0000 0002 - ⚠ Insufficient Funds:
4000 0000 0000 9995
Use any future expiry date and any 3-digit CVC
📋 Quick Reference
Important Links:
Support:
- 📧 Email: support@aiguardsoc.com
- 💬 Slack: #guardsoc-support
- 📚 Docs: /documentation