To use Stripe as an online payment processor, first of all, you need to create a Stripe account and configure it within BRM settings:
There are two modes in Stripe you need to know about - TEST mode and LIVE mode. We recommend all users start with TEST mode to practice using BRM before going live.
First of all, log into your Stripe account and find the API keys page under the Developers menu:
Configuring BRM with Stripe in TEST mode
To begin with wire up your TEST account to be BRM. On the API keys page in Stripe you will see a toggle in the top right to switch between TEST and LIVE data - ensure you are "Viewing test data" for this setup. Further down the page will be two numbers you'll need to copy and paste into BRM one at a time - the Publishable key and the Secret key. Take great care not to mix up these keys else the configuration will not work.
Now go to your BRM and navigate to Settings->Online Payment Method:
On that page choose Stripe in the dropdown and then copy and paste in your keys from your Stripe back office:
SAVE your changes.
With Stripe in TEST mode, will only be able to add TEST cards. You can make up test cards according to the following rules:
- TEST card number: (see table below for test cards by region)
- Expiration date - anything valid (i.e. in the future)
- 3 digits - any digits
Test card number
|United States (US)||4242 4242 4242 4242||Visa|
|Canada (CA)||4000 0012 4000 0000||Visa|
|Belgium (BE)||4000 0005 6000 0004||Visa|
|Finland (FI)||4000 0024 6000 0001||Visa|
|France (FR)||4000 0025 0000 0003||Visa|
|Germany (DE)||4000 0027 6000 0016||Visa|
|Italy (IT)||4000 0038 0000 0008||Visa|
|Netherlands (NL)||4000 0052 8000 0002||Visa|
|Norway (NO)||4000 0057 8000 0007||Visa|
|Portugal (PT)||4000 0062 0000 0007||Visa|
|Spain (ES)||4000 0072 4000 0007||Visa|
|Switzerland (CH)||4000 0075 6000 0009||Visa|
|United Kingdom (GB)||4000 0082 6000 0000||Visa|
|United Kingdom (GB)||4000 0582 6000 0005||Visa (Debit)|
|Australia (AU)||4000 0003 6000 0006||Visa|
|Japan (JP)||4000 0039 2000 0003||Visa|
|Japan (JP)||3530 1113 3330 0000||JCB|
|New Zealand (NZ)||4000 0055 4000 0008||Visa|
More test card numbers can by found on this Stripe support page: https://stripe.com/docs/testing#international-cards
You will be able to see this card in the Stripe reference when you look at that reservation (and a link when you look at that customer). You can also add dummy transactions too.
Configuring BRM with Stripe in LIVE mode
Once you have practiced using BRM with Stripe in TEST mode, you are ready to switch to LIVE data. Making the switch is simple. Go back into Stripe and navigate back to the API keys page. Now change the toggle on the top right of the page from "Viewing test data" to "Viewing live data". You will see the Publishable and Secret keys on the page below change. These are now the keys for REAL data. Copy and paste these into BRM as outlined above, taking great care now to mix up the keys.
Before processing REAL cards and making REAL transactions, first make sure you have enabled your Stripe account to accept live payments.
Something to watch out for
Please Note - you can't mix up a BRM account with TEST and LIVE cards, meaning the following:
Imagine you create user Mr TEST when you have Stripe TEST mode.
You save a TEST card, 4242...
Then you GO LIVE.
If you try to use Mr TEST again but with a REAL LIVE card you will get an error - coz you can't mix TEST and LIVE accounts.
To avoid this scenario, simply create a new BRM user e.g. Mr REAL - and save a LIVE card against him.
Please contact firstname.lastname@example.org before changing the Stripe account in case of a company being sold or transferred ownership. All existing customers are linked to their respective accounts in Stripe and just changing the Stripe account will break that relationship with BRM and the Stripe customer.
setting what % of the payment you take for online bookings