Billing & Payments
ToolChat uses Stripe to handle all payments. This guide covers everything you need to know about billing.
Connecting Stripe
First-Time Setup
- Go to Admin → Billing
- Click Connect Stripe Account
- You'll be redirected to Stripe
Stripe Onboarding
Complete Stripe's verification:
- Business/personal information
- Bank account for payouts
- Identity verification
- Tax information
Complete All Steps
You cannot accept live payments until Stripe verification is complete. This typically takes 1-2 business days.
Stripe Dashboard Access
After connecting, you can access your Stripe Dashboard for:
- Detailed payment analytics
- Issuing refunds
- Managing disputes
- Tax reporting
How Payments Work
Member Checkout Flow
Member Signs Up → Selects Tier → Stripe Checkout → Payment Processed → Access Granted- Member receives invite or visits your checkout page
- Selects their desired tier (if multiple)
- Enters payment information on Stripe Checkout
- Payment is processed
- Member account is activated automatically
Subscription Billing
- Monthly: Charged on the same date each month
- Yearly: Charged once per year on signup anniversary
Stripe handles:
- Recurring charges
- Failed payment retries
- Card expiration updates
- Subscription lifecycle
Viewing Billing Information
Admin Dashboard
Go to Admin → Billing to see:
- Connected Stripe account status
- Quick revenue metrics
- Recent transactions
Detailed Analytics
For detailed billing data, use your Stripe Dashboard:
- Revenue trends
- Subscription analytics
- Customer lifetime value
- Churn rates
Managing Subscriptions
Changing a Member's Tier
- Go to Admin → Members
- Click on the member
- Select new tier
- Changes take effect immediately
Proration: When upgrading, Stripe prorates the charge. When downgrading, credit is applied to next invoice.
Cancelling a Subscription
You can cancel on behalf of a member:
- Go to Admin → Members
- Click on the member
- Click Cancel Subscription
Members can also self-cancel through their account settings.
Issuing Refunds
Refunds are handled through Stripe:
- Log into your Stripe Dashboard
- Find the payment
- Click Refund
- Choose full or partial refund
Refund Policy
Establish a clear refund policy and communicate it to members during signup.
Failed Payments
What Happens
When a payment fails:
- Stripe automatically retries (up to 4 times over ~3 weeks)
- Member status changes to "Past Due"
- After all retries fail, subscription is cancelled
Grace Period
Members in "Past Due" status:
- May still have limited access (configurable)
- Can update their payment method
- Will be charged immediately upon updating
Pricing & Fees
Stripe Fees
Standard Stripe processing fees:
- 2.9% + $0.30 per successful card charge
- Additional fees for international cards
ToolChat Fees
ToolChat platform fees:
- Check your current plan for applicable fees
- Fees are deducted from your Stripe payouts
Example Calculation
Member pays: $49/month
Stripe fee: -$1.72 (2.9% + $0.30)
Your payout: $47.28Payouts
When You Get Paid
Stripe payouts to your bank:
- US: 2 business days (standard)
- Other countries: Varies by country
Payout Schedule
- Daily payouts (default)
- Weekly payouts
- Monthly payouts
Configure in your Stripe Dashboard.
Tax Considerations
Your Responsibility
You are responsible for:
- Collecting applicable taxes
- Sales tax / VAT compliance
- Tax reporting and filing
Stripe Tax
Consider enabling Stripe Tax for automatic:
- Tax calculation
- Tax collection
- Tax reporting
Consult a tax professional for your specific situation.
Troubleshooting
"Connect Stripe" Not Working
- Clear browser cache
- Disable ad blockers
- Try a different browser
- Contact support if issue persists
Payment Failed
- Ask member to update payment method
- Check Stripe Dashboard for decline reason
- Common reasons: insufficient funds, expired card, fraud prevention
Subscription Not Active
- Verify payment was successful in Stripe
- Check member status in Admin → Members
- Try having member log out and back in
- Contact support if issue persists