If you chose to enable Stripe in your marketplace, you'll then be able to collect a transaction fee, providers will be able to receive money in their bank account and buyers will be able to pay by credit card.
To get it working, you'll need a free Stripe account, get your API keys from Stripe and add them to your marketplace admin panel.
Follow the instructions closely and it will work smoothly!
Create and confirm your free Stripe account
Creating a Stripe account is free and you can delete it anytime. If you already have a Stripe account (for another project), it's better to create a new one to avoid any interference.
Note that right now, once you have configured your Stripe account in your Sharetribe marketplace, you won't be able to change it to another one. You can always update all details (bank account, account name...) in your Stripe dashboard but using another new account later isn't possible for the time being.
To create your Stripe account:
- Fill in the email and password fields, then create your Stripe account
Great! You can skip the first question by clicking "Skip to dashboard" and you now have to confirm your Stripe email to confirm your account.
Confirm your Stripe account
To confirm your Stripe email and account:
- Check your email inbox and look for a confirmation email sent from Stripe (by firstname.lastname@example.org) named Confirm your Stripe email address!
- Click the confirmation link in this email and log in with your credentials recently created
Yeah! Your Stripe account is now confirmed. You should now activate it to be able to receive money via this Stripe account.
Activate your Stripe account
As you will receive money from your users via your Stripe account, you have to provide some details such as your address and your bank account. This data is secured by Stripe and won't be shared with anyone.
To activate your Stripe account:
- Log in your Stripe account and click the Activate your account link in the left menu
- Complete all the fields according to the instructions and set Your website to your Sharetribe marketplace address when asked. It's OK to activate your account as an individual, you don't need a company ID. Stripe may review your account later but you are able to activate it immediately.
- The activation form varies based on your country, so select that first!
- Any doubt or question? Contact Sharetribe's support.
- Once completed, click "Activate account".
Good job! Now you need to enable Connect in your platform so your sellers can add their bank details in their settings.
Enable Stripe Connect in your platform
Sharetribe uses the Stripe Connect features with Custom Accounts and you have to enable it to enjoy those features.
This step is important: without this step, providers will not be able to receive money and buyers will not be able to start any transaction.
To enable Stripe Connect:
- Click the Connect left menu item.
- Click the Get started button.
- If you are in the US, your account has to be reviewed by the Stripe team. You can learn more about this process here.
- After a few seconds or the review process, you should see your Connect dashboard. From the left sidebar, go to Settings then Connect settings, at https://dashboard.stripe.com/settings
- Make sure that Custom is enabled in the Account types section
Great! You now have to get your API keys and input them into your marketplace.
Get your API keys from Stripe and add them to your Sharetribe marketplace
API keys are some text strings that have one technical purpose: link your Sharetribe marketplace with your Stripe account, so you can manage payments in your marketplace.
First, get your API keys from Stripe:
- Click "Developers" → "API Keys" in the left menu item.
- Make sure that you are not using test data. If this is the case, switche the View test data toggle. Test API keys will not work in your Sharetribe marketplace.
- Copy the value from the Publishable key row, from the Token column. It should look like
- Paste that value in your Sharetribe marketplace admin panel, in the Payment system tab, in the Stripe section, in the Publishable key field.
- Go back to your Stripe account, in the API tab and click the Reveal live key token button.
- Copy the value from the Secret key row, from the Token column. It should look like
- Paste that value in your Sharetribe marketplace admin panel, in the Payment system tab, in the Stripe section, in the Secret key field.
- In your Sharetribe marketplace, click the Save Stripe API keys button
- Stripe should now be connected and a confirmation should appear.
That's it! You have now connected your Stripe account and are ready to receive payments in your marketplace!