How to set up Stripe payment method?

This service is provided by a third party company. We don’t take any responsibility for any changes in how this service operates or works. Any issue with this service you need to take directly to Stripe team.

How to integrate Stripe?


1. Register new Stripe account or login to your existing one.
2. Copy API keys from Stripe settings page: Live publishable key and Live secret key and paste it to Software -> Settings -> Payment Method -> Stripe Payment -> paste API keys -> click Active -> Save

a) Stripe account API tab.

 

b) Software Stripe payment method tab.

 

Important! An API key that contains dots, e.g. "sk_live_..." is incomplete and the integration will not work. Please note that by default Stripe only displays the full API key when creating it, and after closing the create window it is only partially displayed. In order to receive a full "Live secret key", a new one must be generated and then entered in the ETO account settings.

Important! The way Stripe is processing payments is changing. To continue taking payments via a widget on your website it is absolutely vital that you have a valid SSL certificate (https) on your website. If you do not have https in your website URL, then you do not have an SSL Certificate, and need to obtain one in order to keep using the EasyTaxiOffice. Contact your server provider in order to do so.

Important! Strong Customer Authentication (SCA), a new rule coming into effect on September 14, 2019, as part of PSD2 regulation in Europe, will require changes to how your European customers authenticate online payments. Card payments will require a different user experience, namely 3D Secure, in order to meet SCA requirements. Transactions that don’t follow the new authentication guidelines may be declined by your customers’ banks. Read more

During the activation of SCA, a Webhook is created. The Webhook is needed to receive payment transaction notifications from Stripe.

To activate SCA go to Settings -> Payment methods -> Stripe and enable “Strong Customer Authentication (SCA)” option. 

 

 

FAQs

I do get emails from Stripe about failing web-hook notifications, what to do?

Web-hooks are used to notify booking software about successful payment transaction which makes transaction to be automatically mark as paid in your admin panel. The issue with failing web-hook might arise when the software URL has been changed since the date when web-hook has been set up. To fix this issue please go to Settings -> Payment Methods -> Stripe and deactivate “Strong Customer Authentication (SCA)” option and save settings. Next go back and reactivate this option and save settings again. This steps above will reset web-hook and make payment notification to work as before.

 

When I press on Book Now button I see this message “You must provide one of items or sessionId.”,  what to do? 

In case you see this error message please make sure you have correctly copied "Live publishable key" and "Live secret key" from your Stripe account into the payment configuration tab in the admin panel. Please note that for security reasons Stripe displays partially "Live secret key" e.g. "sk__xyz..." which is not valid key. In this case you should generate new "Live secret key". The minimum amount cannot be lower than $0.50 US or equivalent in charge currency.

If you are on Self-managed solution please check if you are using PHP 7.4 or higher if so change it to PHP 7.1, 7.2 or 7.3 and try again. If you are not sure how to do it please contact your hosting company and ask them to do it for you. To check which PHP version is currently active on your server go to Settings -> Debug tab in your admin panel.

 

When I press on Book Now button system is not redirecting to payment page,  what to do?

Please make sure your SSL certificate has been installed correctly and the connection with the software is secured (green padlock).

 

When making a payment I get this error message “Your card was declined. Your request was in test mode, but used a non test”,  what to do?

This error occurs when you set TEST keys in LIVE mode. Please make sure your Live publishable key and Live secret key are setup correctly.

 

Admin and Customers are getting too many copies of the same booking confirmation email to their mailbox, what to do?

This might happen when you have too many webhooks activated in your Stripe account for the same post payment notification URL. To fix this issue you need to login to your Stripe account and navigate to Developers -> Webhooks tab and remove all duplicated URLs displayed in your account. To delete webhook click on the URL and then Delete button. Next login to your booking admin panel and navigate to Settings -> Payment methods tab and click edit Stripe. In the edit tab disable the option “Strong Customer Authentication (SCA)” and save settings. Once this is done enable this option again and save settings, this process will set new webhook in your Stripe account. Please see attached screenshot below for more information.