Connect mani to Stripe
Before you start
- ☐ A Stripe account with at least 1 customer
- ☐ A mani account (Pro plan or above)
- ☐ Stripe API key (found in Developers > API Keys)
Setup steps
Get your Stripe API key
In Stripe Dashboard, go to Developers > API Keys. Copy the Restricted key (or create one with read-only access to customers and subscriptions).
What good looks like
A key starting with 'rk_live_' or 'sk_test_' copied.
Common errors
Never use the Secret key directly. Create a restricted key with minimal permissions.
Connect in mani
Settings > Integrations > Stripe > Connect. Paste API key.
What good looks like
Status: Connected with Stripe account name.
Common errors
Restricted keys need 'customers:read' and 'subscriptions:read' permissions.
Configure customer segments
Choose which Stripe events trigger creative: new customer, subscription renewed, payment failed.
What good looks like
Event toggles show green for enabled events.
Common errors
Events require Pro plan webhooks.
Generate retention creative
Mani generates retention, upsell, and win-back ads based on customer lifecycle events.
What good looks like
Ads reference subscription tiers and customer value segments.
Common errors
If generic, verify Stripe data is syncing.
Test with a test-mode event
Use Stripe test mode to create a test customer. Verify mani generates creative.
What good looks like
Test creative appears in queue within 5 minutes.
Common errors
Ensure test mode key matches (sk_test_ not sk_live_).
What you can do once connected
Troubleshooting
API key rejected
Use a restricted key with customers:read + subscriptions:read. Full secret keys are not accepted.
No events triggering
Check Stripe > Developers > Webhooks for mani's endpoint. Verify delivery status.
Customer data not appearing
Stripe sync runs every hour. Recent customers appear within 60 minutes.
Disconnect
Settings > Integrations > Stripe > Disconnect. API key deleted. Stripe account unaffected.
Questions
Is my payment data safe?+
Mani only reads customer names, subscription tiers, and lifecycle events. We never access card numbers, bank details, or transaction amounts.
Which Stripe data does mani use?+
Customer count by tier, subscription lifecycle events (new, renewed, cancelled), and aggregate revenue segments.
Can I use test mode first?+
Yes. Connect with a test-mode API key to verify the integration before going live.
Does this work with Stripe Billing?+
Yes. Mani reads subscription and invoice events from Stripe Billing.