Connect Stripe
Link your Stripe account and understand how checkout, billing, refunds, and fees work.
Arcalotl uses Stripe Connect (Direct Charges) to process payments. Money goes directly to your Stripe account. Arcalotl never holds your funds.
How it works
- Open your community's Settings in the dashboard and press Connect Stripe (in-platform setup commands link to the same flow)
- Pick one of two options: use a Stripe account you already have, or have Arcalotl set one up for you without leaving the dashboard
- Sign in to Stripe, or fill in what Stripe asks for
- Authorize Arcalotl to create charges on your behalf
- Return to the dashboard; the payment status updates on Settings
Arcalotl collects its platform fee as a Stripe application fee. You can review those fees in Stripe alongside the connected account's charges.
Which option should I pick?
Both options end with the same kind of account: a full Stripe account in your name, with the Stripe Dashboard, that you keep if you ever stop using Arcalotl.
Use your own Stripe account if you already have one, run a business that is already on Stripe, or plan to sell anywhere else. You sign in on stripe.com, or create an account there in a few minutes, and Arcalotl only gets permission to run checkouts on it. This works in every country Stripe supports.
Set one up here if you have never used Stripe and want the shortest path. Arcalotl opens the account for you and Stripe's form runs inside the dashboard. You pick your country first, because Stripe locks the country the moment the account exists. The list only shows countries Arcalotl can open accounts in; if yours is not there, use your own Stripe account instead.
| Question | Use your own Stripe account | Set one up here |
|---|---|---|
| Who creates the account | You, on stripe.com | Arcalotl, in your country |
| Where the form runs | stripe.com | Inside the dashboard |
| Countries | Everywhere Stripe operates | The countries Arcalotl can open |
| Who handles problems | You and Stripe | You and Stripe |
| Fees | Stripe's processing fee plus Arcalotl's 2% | The same |
| Switching later | Connect a different account from Settings at any time | Connect a different account from Settings at any time |
If you started a setup before September 2026 and never finished it, the dashboard asks you to restart it. Those setups were opened the old way and cannot be completed; nothing you entered is needed again.
What Arcalotl accesses
When you connect your Stripe account, Arcalotl receives:
- Your Stripe account ID, so Arcalotl can create Checkout Sessions, products, prices, subscriptions, coupons, refunds, and card-update sessions in the connected account
- Stripe webhook events, so Arcalotl can track subscription, invoice, refund, dispute, and account status changes
Arcalotl does not receive or store bank account details, tax information, personal financial records, or card numbers.
Checkout and the member portal
When a member chooses a plan, Arcalotl opens its own checkout page for your community. Card entry, payment authentication, and payment method storage happen inside secure Stripe payment fields embedded in that page, so card data never touches Arcalotl's servers. Arcalotl grants access after the payment is confirmed.
Members manage billing in the Arcalotl member portal, linked from /manage
in every bot and from every receipt. Cards are updated through a Stripe card
form inside that portal, so neither you nor your staff ever handle card data.
Cancellation, pausing and plan changes run through Arcalotl's own flows, so
save offers are never bypassed. One-time purchases and donations show in the
portal's payment history but have no subscription to change or cancel.
You do not configure Stripe webhooks by hand. Arcalotl listens for Stripe events on its platform webhook endpoint and updates access, retention flows, and dashboard data from those events.
Using an existing Stripe account
If you already have a Stripe account with other products or subscriptions, you can still connect it. Arcalotl creates products and prices in that account for plans created through Arcalotl, and existing objects are left alone.
If you already have Stripe products with monthly or annual prices, you can import plans after connecting Stripe.
Refunds and disputes
When refund or dispute events affect access, Arcalotl resolves the related subscription or purchase and updates access automatically.
For creator-initiated refunds, the dashboard Subscribers view supports Cancel at period end and Refund and cancel. Use Stripe directly for partial refunds or older charges.
Fees
| Fee | Amount | When |
|---|---|---|
| Stripe processing | Stripe's current processing rate | Every transaction |
| Arcalotl transaction fee | 2% | Every successful payment |
For the full fee breakdown, see Pricing.