Setup & Accounts

TatTool uses Stripe Connect, which means you can connect multiple Stripe accounts to the same organization.

---

Install The Stripe Payments Extension

1. Go to Extensions
2. Open Stripe Payments
3. Click Install

---

Connect A Stripe Account (Stripe Connect)

1. Go to Stripe Payments → Settings
2. Under Connect Account, connect a Stripe account
3. Complete Stripe onboarding

You can connect additional Stripe accounts later if needed.

---

Stripe Webhooks

Stripe Payments uses two webhook endpoints:

• Platform webhook: /webhook/stripe
  • Handles Checkout, PaymentIntent, refund, and dispute events for payment requests.
  • Treats Checkout Sessions as payment requests only when the event metadata contains paymentRequestId or requestCode.
  • Also handles TatTool subscription, product, price, and customer sync events.
• Connect webhook: /webhook/stripe-connect
  • Handles connected-account lifecycle events such as account updates, deauthorization, and external account changes.
  • Can also receive payment events during configuration transitions; TatTool processes them idempotently.

Use the existing STRIPE_WEBHOOK_SECRET for the platform webhook and STRIPE_CONNECT_WEBHOOK_SECRET for the Connect webhook.

---

Stripe Account Structures (You Decide)

Common setups include:

• One Stripe account per location
• Individual Stripe accounts per artist
• A shared Stripe account for the entire organization

TatTool does not enforce how accounts are structured. Your organization is responsible for choosing which account should receive each payment.