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->Payment Processors:




On that page choose Stripe in the dropdown and then copy and paste in your keys from your Stripe back office:

SAVE your changes.



TEST cards

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
Country
Test card number
Card Brand
United States (US)4242 4242 4242 4242Visa
Canada (CA)4000 0012 4000 0000Visa
Belgium (BE)4000 0005 6000 0004Visa
Finland (FI)4000 0024 6000 0001Visa
France (FR)4000 0025 0000 0003Visa
Germany (DE)4000 0027 6000 0016Visa
Italy (IT)4000 0038 0000 0008Visa
Netherlands (NL)4000 0052 8000 0002Visa
Norway (NO)4000 0057 8000 0007Visa
Portugal (PT)4000 0062 0000 0007Visa
Spain (ES)4000 0072 4000 0007Visa
Switzerland (CH)4000 0075 6000 0009Visa
United Kingdom (GB)4000 0082 6000 0000Visa
United Kingdom (GB)4000 0582 6000 0005Visa (Debit)
Australia (AU)4000 0003 6000 0006Visa
Japan (JP)4000 0039 2000 0003Visa
Japan (JP)3530 1113 3330 0000JCB
New Zealand (NZ)4000 0055 4000 0008Visa

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.


See Also

setting what % of the payment you take for online bookings