Help for app owners
Setting up Stripe for Barcade OS
Connect your own Stripe account so your operators can pay you, and pay by card. It takes about 20–30 minutes. Stripe is optional: until you connect it, everything works with cash or check payments.
What you’ll need
- A Stripe account in the United States (US Dollar, USD). Your owner console checks the country and currency when you connect.
- About 20–30 minutes. About 15 of them are in your owner console; the rest is in Stripe.
- Your sign-in for multipliers.ai, to open your owner console.
Who holds what
- Connect your own Stripe account. Your operators’ plan payments go to you, and their customers’ card payments go to them. Multipliers never handles this money.
- multipliers.ai never sees your Stripe key and never holds your money.
- Plan payments from your operators go into your Stripe account.
- Stripe pays your balance out to your bank automatically.
Never share this key with anyone, including multipliers.ai staff. Paste it only into your owner console (Payments → Connect Stripe → Paste your key). We never ask for it by email, chat or phone.
In Stripe: your account and Connect
Your Stripe account
- Sign in to Stripe, or create a free Stripe account.Use the account you want your plan payments and fees to go to.
- To take real payments later, activate the account in Stripe: your business details, your identity and a bank account for payouts.Only you can enter these, and only in Stripe — we never fill them in for you. You can do everything in this guide in test mode first.
Turn on Connect
Skip this if Connect is already on. In Stripe’s Connect setup, choose these:
- In Stripe, open Connect and click “Get started”.Connect lets your operators take payments under your Stripe account.
- How funds flow: choose “Sellers will collect payments directly”.Each operator’s customers pay that operator directly — the money never passes through you or us.
- Industry: choose “Business management software”.That’s what this app is to Stripe.
- Onboarding: choose “Onboarding hosted by Stripe”.Stripe collects each operator’s details on its own secure pages.
- Dashboard for sellers: choose “Stripe Dashboard”.Each operator manages refunds and payouts in their own Stripe Dashboard.
- Risk and loss liability: choose Stripe.Stripe covers fraud and negative balances, and each operator pays Stripe’s fees — not you.
Optional: Stripe Tax
Optional: if you want tax added to the plan payments your operators make to you, set up Stripe Tax in your own Stripe account (Settings → Tax). Stripe calculates the tax; this app never calculates or stores tax.
Create the restricted key
In Stripe’s menu this is under Developers → API keys. Open API keys in Stripe (test mode) (opens in a new tab)
- Open API keys in Stripe (opens a new tab) — make sure Stripe is in test mode.This is where Stripe makes keys for other software.
- Click “Create restricted key”.A restricted key can only do what you allow — safer than your secret key.
- When Stripe asks how you’ll use the key, choose “Powering an integration you built”.You built this integration with us, not with an app from Stripe’s marketplace.
- Choose the “Custom” template.Custom lets you set each permission yourself.
- Name it the way your owner console shows it, for example “My app on Multipliers”.So you can tell this key apart later.
- Set each permission below in the “Permissions” column. Leave the “Connect permissions” column at None. Anything not listed stays None.The app asks only for what it needs; everything else stays off.
- Click “Create key”, complete Stripe’s check, then copy the key. Stripe shows it only once.You’ll paste it into the next step.
The permissions to set
Stripe’s editor has two columns: “Permissions” (your own account) and “Connect permissions” (your operators’ accounts). Set each row below. Anything not listed stays None.
| Row in Stripe | Permissions | Connect permissions | Why the app needs it |
|---|---|---|---|
| Accounts v2 (Accounts v2) | Read | None | Checks that Connect is on and reads your operators’ Stripe accounts. |
| Customer Configuration (Accounts v2) | Write | None | Creates a Stripe account for each operator so you can bill its plan. |
| Account Links (Connect) | Write | None | Opens Stripe’s own setup pages for each operator. |
| Accounts (Connect) | Read | None | Reads your Stripe account’s country and currency. |
| Customers (Core) | Write | None | Keeps the billing records for plans (and saved cards in Clinic OS). |
| Products (Core) | Write | None | Puts your plans in your Stripe account. |
| Balance (Core) | Read | None | Shows your balance (read only). |
| Payouts (Core) | Read | None | Shows payouts to your bank (read only — Stripe pays out automatically). |
| Events (Core) | Read | None | Catches up on any payment notification that was missed. |
| Checkout Sessions (Checkout) | Write | None | Opens Stripe’s secure payment page — card details never reach this app. |
| Prices (Billing) | Write | None | Puts your plans’ prices in your Stripe account. |
| Subscriptions (Billing) | Write | None | Bills each operator’s plan every month or year. |
| Invoices (Billing) | Read | None | Shows whether a plan payment went through. |
| Customer portal (Billing) | Write | None | Lets a operator update its card or cancel its plan on Stripe’s page. |
| Tax Calculations and Transactions (Tax) | Write | None | Asks Stripe Tax for the tax on a price. This app never calculates tax. |
| Tax Settings and Registrations (Tax) | Read | None | Shows whether Stripe Tax is set up. |
| Webhook Endpoints (Webhooks)Only while connecting: lower to None after setup | Write | None | Sets up payment notifications once. Afterwards set it back to None. |
Leave these at None: Recipient Configuration, Transfers, Top-Ups, Login Links, Account Sessions.
In your owner console
- Open your owner console and go to Payments. Press “Connect Stripe”.You open the owner console from your account on multipliers.ai: sign in, then press “Open owner console”.
- Before you start: tick off what you need.You have already done the Stripe part above.
- Test or live: choose “Test first (recommended)”.Test mode lets you try everything with Stripe’s test cards. You can go live later.
- Create your key: you have already made it. The console shows the same list, with the key name to copy.
- Paste your key: paste the key and press “Check my key”.If you signed in more than a few minutes ago, the console first asks you to confirm it’s you. We check the key with Stripe, then store it in your app’s own secret store.
- Result: each line says “✓ Done” or “✕ To do”.Fix any “To do” line in Stripe (open the key, then “Edit key”), then press “Check now” on Payments.
What the status means
Payments → “Your Stripe account” shows a status, and “Test mode” or “Live” once connected:
- Connected
- Your key works and has every permission it needs. Your Stripe is connected.
- Missing permissions
- Your key works, but one or more permissions are missing. The card names each one and its column. Online payments stay off until you fix them.
- Key not working
- Stripe no longer accepts the key (it was deleted, rolled or expired). New online payments pause; cash and manual records keep working. Create a new key and replace it.
- Not connected
- No Stripe account is connected yet. Everything works with cash or check payments until you connect one.
- Disconnected
- You disconnected Stripe. Online payments are off; you can connect again at any time.
- Not available yet
- Payments aren’t switched on for your app yet. Contact support.
After connecting
- Invite each operator to set up billing: open the operator in your owner console and press “Invite to set up billing”.The operator sets up the Stripe account you bill their plan to, in their own app.
- Start plan billing: open a operator and press “Start billing”.The operator gets an email to add a card on Stripe’s secure page. Billing starts when they do.
- In Stripe, set Webhook Endpoints on your key back to None. Then press “I’ve done this” on Payments.It was needed only while connecting. A smaller key is safer.
Test mode and live
Start in test mode: in the “Test or live” step, choose “Test first (recommended)”. Test mode lets you try everything with Stripe’s test cards. You can go live later. No real money moves in test mode.
Live mode is switched on for each app separately. Until it is on for yours, the “Live” choice is greyed out and the console says: “Live payments aren’t switched on for your app yet.”
A one-step switch from a test connection to live isn’t in the owner console yet. When live payments are on for your app, email us and we’ll help you move over.
Help
Questions? Email multipliers@kiwana.ai.
We will never ask you for your Stripe keys or any password, by email or on a call.