Stripe Integration
Floatless uses Stripe as its payment processor for collecting payments and managing payment methods.
When should I read this?
Read this if you need to connect a Stripe account, understand how data syncs between systems, or troubleshoot integration issues.
What Stripe handles
| Function | Provider |
|---|---|
| Payment processing | Stripe |
| Payment method storage | Stripe |
| Customer identity | Floatless (synced to Stripe) |
| Subscription logic | Floatless |
| Invoice generation | Floatless |
| Revenue reporting | Floatless |
Connecting Stripe
- Go to Settings → Integrations
- Click "Connect Stripe"
- Authorize Floatless in Stripe OAuth flow
- Connection confirmed
Data synchronization
Floatless → Stripe
- Customer records
- Payment intents for invoices
- Subscription metadata
Stripe → Floatless
- Payment confirmations
- Refund events
- Dispute notifications
- Payment method updates
Webhook events
Floatless listens for these Stripe webhooks:
| Event | Action |
|---|---|
payment_intent.succeeded |
Mark invoice as paid |
payment_intent.payment_failed |
Record failure, trigger retry |
charge.refunded |
Create credit/adjustment |
charge.dispute.created |
Flag for review |
Testing mode
Use Stripe test mode for development:
- Test API keys (starts with
sk_test_) - Test card numbers (4242424242424242)
- No real charges
Troubleshooting
| Issue | Solution |
|---|---|
| Webhooks not received | Verify endpoint URL, check Stripe logs |
| Payment method fails | Customer needs to update card |
| Sync delays | Events processed within minutes |