Skip to main content
All CollectionsPaymentsStripe
Integrating with Stripe
Integrating with Stripe

How to integrate your Bookwhen account with Stripe to start taking secure online payments

Eloise avatar
Written by Eloise
Updated over a week ago

✨ Please note: Online payments are available on the Lite plan or above.

This article covers:


Creating a Stripe account

There are two ways to create a Stripe account:

Directly from your Bookwhen account

You can create a new Stripe account by selecting Settings from the left-hand menu, then Payments.

From here, select Setup next to the Stripe option, then Connect with Stripe:

You will then be redirected to Stripe to register your new account.


💡 If you choose this method and create your Stripe account via your Bookwhen account instead of directly via Stripe, your Bookwhen admin email address will automatically be used for your new Stripe account by default.


Directly from Stripe

Alternatively, you can register directly with Stripe. You will need to verify your email address and activate your account by submitting account information regarding your business and your bank account.

Once you've set up your Stripe account, you'll need to connect your account with your Bookwhen account.


Connecting your Stripe account with Bookwhen

1 . Log into your Stripe account on another tab on your web browser.

2. Select Settings from the left-hand menu, then Payments.

💡 Please note - that you will need to be an Account Owner to access this page.

3. Select Setup next to the Stripe option, then the Connect with Stripe button:

4. Select Done once you've followed the steps within Stripe.

5. Your Stripe account will be successfully integrated with your Bookwhen account.

Stripe will then process all online payments made on your bookings. If needed, you can add online payment fees on your Stripe settings by selecting Edit below:

💡 Before setting a fee, please be aware of the Surcharge ban under PSD2 rules covering all EEA businesses. It is illegal to charge additional debit or credit card payment fees. Exemptions apply.

If you'd like to make a test booking before taking payment from your customers, we'd recommend setting your ticket cost to a low amount or creating a discount code to cover most of your ticket value.

💡 To note:


Payout timing for new Stripe accounts

For new Stripe accounts, the first payout usually occurs seven days after receiving your first successful payment. In some industries, this waiting period can be up to 14 days. This delay helps Stripe reduce risks associated with providing credit services.


Stripe digit limitation

According to Stripe's documentation on currencies, the maximum amount you can charge a customer is technically limited by the number of digits allowed:

  • You can charge up to 12 digits for Indonesian Rupiah (IDR) (e.g., 999999999 for 9,999,999,999.99 IDR).

  • For all other currencies, you can charge up to 8 digits (e.g., 99999999 for 999,999.99 USD).


Important configuration note

When updating payment methods on Stripe, please follow these steps to ensure proper integration with Bookwhen:

  1. Select the correct configuration:

    • Bookwhen has its own configuration settings that differ from the default Stripe configuration. Always choose the Bookwhen configuration when making changes to your payment methods.

  2. Avoid 'default' configuration for Klarna:

    • It's easy to accidentally enable Klarna using the default configuration. To prevent issues, please ensure you select the Bookwhen configuration specifically.


💬 Any questions or feedback? There are two ways to get in touch:

Thank you! 🕺

Did this answer your question?