Connect your own Stripe account, and clients can pay you directly by card, Apple Pay or bank transfer.
The money goes straight to you, and SoloBase takes 0%. Stripe's normal fees apply.
Before you start
You need a Stripe account in your name. To take real payments, Stripe asks for your business and bank details. If SoloBase says “This Stripe account can't take real payments yet”, finish that in Stripe, then press Connect again.
Connect your account
Make a key
Go to Settings › Payments and click Test key. Stripe opens with the name and permissions filled in. You can also press Connect on a proposal, and your draft stays.
Paste it
Copy the key from Stripe, paste it into SoloBase, and click Connect.
Go live
When you're ready for real money, make a Live key, paste it, and press Go live.
1. Make a key in Stripe
In Settings › Payments, press Test key. Stripe opens in a new tab, on its page for making a key, with the name SoloBase and the nine permissions already filled in. Sign in to Stripe if it asks.
Create the key, then copy the whole key. It's one long line.
A key made for SoloBase is a restricted key. It starts with rk_test_, or rk_live_ for a live key. Never paste a secret key, the kind that starts with sk_. A secret key can do everything in your Stripe account, and SoloBase warns you if what you paste doesn't start with rk_.
2. Paste it in SoloBase
Back in Settings › Payments, paste the key into the box and press Connect. SoloBase checks the key with Stripe, one permission at a time, before it saves.
If all is well, the permissions show as ticked. If one is missing, it shows in amber with a line saying what SoloBase uses it for. Press Fix in Stripe, add it there, and press Save again.
3. Try it, then go live
With a test key, nothing is really charged. Settings › Payments shows Stripe's test card, 4242 4242 4242 4242, with a Copy button. Use any future date, any 3 digits and any ZIP, and buy from your own Hub.
When you're ready for real money:
Make a live key
Press Live key. The same page opens in Stripe, for your real account.
Paste it
Paste the rk_live_ key into the box.
Go live
Press Go live. Clients can now pay you for real.
What the key can do
The key lets SoloBase create checkouts, customers, prices, invoices and subscriptions for you. It never lets SoloBase see your balance, make a refund or move money.
Settings › Payments lists all nine: Checkout, Customers, Products, Prices, Invoices, Subscriptions, Customer portal, Webhooks and Events. Press Details to read what each one is for.
Invoices and subscriptions can charge a client's saved card, and only ever into your account. Revoke the key in Stripe at any time and SoloBase loses access at once.
If something goes wrong
It says the key is missing permissions.
The missing ones show in amber. Press Fix in Stripe, add them, and save again.
Stripe didn't accept the key.
It may be cut short, or deleted in Stripe. Copy it again from Stripe, the whole line, and paste it here. Still stuck? Write to support@solobase.org and we'll do it with you.
It says this Stripe account can't take real payments yet.
Finish activating it in Stripe. It takes your business and bank details. Then press Connect again.
It warns me about rk_ and sk_.
A restricted key starts with rk_test_ or rk_live_. Never paste a secret key, the kind that starts with sk_.
Monthly payments say my key needs two more permissions.
A key made before Sep 30 lacks Subscriptions and Customer portal. Press Edit key in Stripe, add them, then press Recheck.
Clients can only pay by card.
Bank payments may be off in your Stripe. On the proposal's payments, press Turn on bank payments.
How do I change the key or disconnect?
Click the ⋯ beside your connected Stripe, then Use another key or Disconnect.
Next
Was this doc helpful?