Set up Stripe for Tixoola
Create your Stripe account, verify your business, link your bank account, then connect Stripe to Tixoola. Use Test mode first and switch to Live when you’re ready. Need your own payouts? Use Stripe Connect Express.
Stripe Payments
PCI-aware • 3DS
Test & Live modes
A. Organizers — Business setup
- Create your Stripe account and complete identity verification.
- Enter business details and statement descriptor.
- Link a bank account for payouts (can be updated later).
- Enable card payments and review pricing.
- Optional: verify domains for Apple Pay / enable Google Pay.
B. Developers — Integration prep
- Dashboard → Developers → API keys (use Test keys first).
- Copy Publishable & Secret keys (keep Secret safe).
- Create a Webhook endpoint (if needed) and save its signing secret.
- If using Connect: set OAuth redirect URLs shown in Tixoola.
- Test with Stripe test cards → switch to Live keys when ready.
C. Stripe Connect Express — your org gets paid directly
Destination charges • Transfers
When to use Connect Express
- You (or sub-orgs/chapters) need payouts into your own bank.
- You want to show your business name on receipts/payouts.
- You need per-org reporting and tax/KYC handled by Stripe.
How onboarding works (high level)
- Create a Connected Account (type=express).
- Generate an Account Link (type=account_onboarding) with return & refresh URLs.
- Stripe collects KYC, bank, and capability info (card_payments, transfers).
- You receive the connected account ID; payouts flow to their bank.
Key implementation notes
- Charges & fees: use destination charges or separate charges & transfers; set application_fee_amount for your platform fee.
- Capabilities: request card_payments and transfers; Stripe may require more info before enabling payouts.
- Webhooks to watch: account.updated, account.application.deauthorized, payment_intent.succeeded, charge.succeeded, transfer.created.
- Compliance: review restricted businesses and ensure connected accounts meet KYC requirements.
Connect Stripe to Tixoola
- In Tixoola: Settings → Integrations → Stripe.
- Click “Connect Stripe” (standard) or “Connect Stripe (Express)” if you need your own payouts.
- For Express: complete Stripe’s onboarding and return to Tixoola with your connected account ID.
- Run a $1 test payment in Test mode to verify end-to-end.
- Switch to Live when you’re ready to go live.
Tips
- Use Test mode first; Live payouts require full verification.
- Store Test vs Live keys separately; label environments clearly.
- For Express, surface onboarding again if Stripe requests more info (account.updated).
- Align Stripe account time zone with your event locale.
Troubleshooting
- “Invalid API key” → check Test vs Live and copy full key.
- “Account needs verification” → finish KYC in Stripe Dashboard.
- 3DS failures → test with 3DS cards; check Radar rules.
- Webhook signature mismatch → use correct signing secret & endpoint URL.
- Express onboarding loop → refresh/return URLs must match exactly.