
Prerequisites
- An existing Stripe account. If you don’t have one, create it at stripe.com.
- Owner or Admin role in ShingleAI — the Stripe Connect card is visible to everyone, but connecting runs under Owner/Admin authority.
Connecting
- Scroll to the Stripe Connect card on the Business page.
- Click Connect Stripe. A Stripe-hosted page opens in a new tab.
- Log in to Stripe and confirm the connection.
- Stripe redirects you back to ShingleAI. The card now shows your Stripe account as linked.
stripeAccountId on the business record. That ID scopes every customer sync and billing action.
What Connect enables
- Customer sync. Stripe customers flow into ShingleAI Customers.
- Account metadata. Stripe’s payout currency, country, and other profile fields become visible.
What Connect does not do
- ShingleAI’s billing. Your ShingleAI subscription is unaffected by the Connect link. You still pay ShingleAI separately — see Admin Guide → Billing.
- Write to Stripe. Today, sync is read-only from Stripe → ShingleAI. There is no “create customer in Stripe from ShingleAI” flow.
Disconnecting
Revoke the connection from your Stripe dashboard (Settings → Connected Accounts). When you revoke, ShingleAI loses read access; existing synced customer records remain in your Customers list but no longer update.Troubleshooting
| Problem | Likely cause | Fix |
|---|---|---|
| OAuth popup blocked | Browser blocker | Allow popups from ShingleAI and retry |
| ”Connection failed” after Stripe | Stripe account requires verification | Complete Stripe onboarding, then retry |
| Customers don’t appear | Sync in progress | Wait a few minutes; initial sync can take time |
Next steps
Customers
See your synced customers
Sync semantics
How sync actually works