Connecting Stripe for Subscription Billing
Adding Your Stripe API Keys
In AcelleMail admin, go to Settings → Payment Gateways → Stripe. Enter your Publishable Key and Secret Key from the Stripe Dashboard. Enable test mode first to verify the integration.
| Key | Where to find it |
|---|---|
| Publishable Key | Stripe Dashboard → API Keys |
| Secret Key | Stripe Dashboard → API Keys (reveal) |
| Webhook Secret | Stripe Dashboard → Webhooks → Signing secret |
Creating a Webhook Endpoint
In Stripe Dashboard, go to Developers → Webhooks → Add endpoint. Set the URL to:
https://yourdomain.com/stripe/webhook
Select these events:
invoice.payment_succeededinvoice.payment_failedcustomer.subscription.deletedcheckout.session.completed
Syncing Plans
After saving Stripe keys in AcelleMail, go to Plans and create a plan. Set the Stripe Price ID field to match the Price ID from your Stripe product catalog (starts with price_).
When a customer subscribes, AcelleMail creates a Stripe customer automatically, attaches the plan, and handles renewal billing. Failed payments trigger a grace period before account suspension.
Testing the Flow
Use Stripe's test card 4242 4242 4242 4242 with any future expiry. Check Stripe Dashboard → Events to confirm webhook delivery and AcelleMail → Subscriptions to verify the new record.