How to Connect Stripe

What This Is

Stripe is the most commonly used payment processor on BRS. Connecting it allows your customers to pay by credit card at checkout with Apple Pay and Google Pay also supported.

Before You Start

•   You need an active Stripe account (stripe.com). If you don't have one, create it first.

•   You need your Live API keys — NOT test keys. Test keys start with pk_test_ and sk_test_ and do not process real payments.

•   Live keys start with pk_live_ and sk_live_.

How to Find Your Stripe API Keys

1.    Log into dashboard.stripe.com

2.    Go to Settings in the top right

3.    Click Developers

4.    Click API Keys

5.    You need two keys: your Publishable Key (starts with pk_live_) and your Secret Key (starts with sk_live_)

6.    Copy both keys — copy and paste the full key, do not retype it manually, one wrong character will break the connection

Important: Secret Key Visibility

Stripe only lets you see your full Secret Key one time when it is created. If you can no longer reveal the key, you must create a new one:

7.    In Stripe, go to API Keys

8.    Click + Create secret key

9.    Copy it immediately and save it somewhere safe — you will not be able to see it again after you leave the page

How to Paste Your Keys into BRS

10.  In your BRS dashboard, go to Website → Checkout Settings → Payment Configurations

11.  Select Stripe as your payment processor

12.  Paste your Publishable Key and Secret Key into the fields

13.  Save your settings

14.  Place a test booking to confirm cards are being processed correctly

If you’re unsure whether Stripe is the right option, see: Which Payment Processor Should I Use

Common Issues

•   500 Internal Server Error when processing a payment — Go to Stripe → Settings → search for 'integration' → Embedded Payments → enable 'Allow card data collection with a publishable key without using Stripe's pre-built UI elements.' Also check that Cards is enabled under Settings → Payments → Payment Methods, and that your Stripe account verification is complete under Business Settings → Account Details.

•   Keys not working — Make sure you are using live keys, not test keys. Test keys will not process real payments on your BRS site.

•   2-Factor Authentication or Passkey blocking access — Stripe requires you to log in from your own device to access API keys. If you are locked out, contact Stripe support directly.

•   Secret key says 'can't be revealed' — Create a new secret key in Stripe (see steps above). This is a Stripe policy change, not a BRS issue.