This is a step by step breakdown on how to setup Stripe for your payments.
Go to https://dashboard.stripe.com/login and log in with your Stripe Credentials.
Once you have logged in, you will see something like this in the picture below. Click on the API button on the left menu, highlighted in orange in the picture.
Once you have clicked the “API” button, a new page will appear. You will see your API keys. Click on the “reveal key token” button, highlighted in orange to reveal the secret key. You will need these keys in a later step.
Do note that there are two different sets of keys for testing and if you are going live. The keys for test server will contain the word test like in the picture above whereas the keys for the live server will contain the words live like in the picture below.
You can toggle between the test and live keys on the bottom left of the menu, highlighted in orange in the picture below. However, you will need to activate your account first beforehand.
Next, set up a new gateway in the system. You can do this by going to Settings > Payment Gateways > Gateways > Add Gateways and click on Stripe.
If you are based in Europe, you will need to choose Stripe SCA as your adapter in order to be in compliance with the P2D2 regulation in Europe. For more information on Stripe SCA, please review Stripe SCA Doc. Please refer to the Stripe SCA section at the end of this article for information on how this adapter works.
Fill in the necessary details which are Label, Supported Currencies, API Token, and API Secret. API Token is Publishable Key and API Secret is Secret Key. They were obtained in step 3. If you are testing this payment gateway, make sure that the Test Mode radio button is set to Yes. Click on the blue “Save” button.
If your company supports multiple currencies, you would need to complete this step, if not, skip to step 7.
Click back on the payment gateway you have just created. Next, navigate to the method tab, highlighted in orange in the picture below.
For every currency that you support, you would have to create a new payment method. Firstly, click the blue “Add” button on the top right of the page, highlighted in orange in the picture below.
Next, a new window will pop up, select the payment method, in this case, is Credit Card and click the blue “Save” button, highlighted in orange in the picture below.
Lastly, a new row will appear, in the currency dropdown list, select the currency that you are supporting and click on the blue “Save” button, highlighted in orange once you have finished.
Next, you will need to select Stripe as the supported payment for your branch. Head to Settings > Car Rental > Online Charges tab (on top) and select the branch that you want to use the Stripe integration with. Scroll down till you reach the Branch Settings category and under Supported Payment Gateways, add in the created Stripe gateway to conclude the setup.
Security Deposits with Stripe
This is how you set up Stripe to accept Security Deposits as Authorization payment.
Navigate to Settings > under Payment Gateways > Settings > Max Days to Keep Authorizations (set the value less than 7 days)
Note: This is usually defined by the payment gateway, and tends to be no more than 7 days. We suggest to set the value 1 day less than what is set by the provider.
Go to Settings > Car Rental > Online Charges > Supported Gateways for Authorizations – only choose accounts with “Credit”
You can set the “Days in Advance to Charge the Security Deposit” – the value you enter in this field will define the how many days before the Pickup date you will charge the security deposit to the renter.
Also, you can activate “Enable Automatic Charges on Security Deposits”- it will authorize the security deposit for the renter automatically.
For more information about Payment Gateways, click on this link here.
Stripe Strong Customer Authentication (SCA)
Charges from Step 6
When charging a customer at the counter from step 6 and adding a credit car as shown in the image below:
The system will redirect you to a confirmation page where your customer can validate the payment.
If the payment validation is successful, then you will be redirected to a confirmation page. If this verification is unsuccessful, then you can try to process the payment again. Please note that the strong customer authentication is only required by certain banks, therefore the confirmation screen will only appear when requested by the bank of the card being charged.
Charges to Cards on File
For charges to cards stored on file, the system will send an email to your customer so they can validate their payment. Please find an example of the process below by adding a payment from step 6:
First, select the card on file to charge.
You will see the payment added as a “Pending Payment”, given that it requires customer authentication.
The system will send an email to your customer informing them that their confirmation is required to process a payment.
This is a sample of the email body:
The link in the email to “Confirm Payment” will take the customer to a confirmation page where they can validate their payment. If the payment validation is successful, then they will be redirected to a confirmation page. If this verification is unsuccessful, then they can process the payment again. Please note that the strong customer authentication is only required by certain banks, therefore the confirmation screen will only appear when requested by the bank of the card being charged.