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. 

 

How to Remove and Re-establish Webhooks in Stripe?

This guide outlines the steps to remove duplicate webhooks in Stripe and re-establish a fresh connection for your booking confirmation emails.

1. Remove Duplicate Webhooks in Stripe:

  1. Log in to your Stripe account.
  2. Navigate to the Developers section and select the Webhooks tab.
  3. Review the listed URLs for any duplicates. These duplicates might be causing multiple email notifications.
  4. Click on a duplicate URL and then click the Delete button to remove it.
  5. Repeat steps 3 and 4 for all identified duplicate URLs.

2. Re-establish Webhook in Booking Admin Panel:

  1. Log in to your booking admin panel.
  2. Navigate to Settings and then the Payment methods tab.
  3. Locate the Stripe settings and click Edit.
  4. Disable the option labeled "Strong Customer Authentication (SCA)".
  5. Save the changes.
  6. Re-enable the "Strong Customer Authentication (SCA)" option.
  7. Save the changes again.

By following these steps, you will remove any duplicate webhooks in Stripe and re-establish a fresh connection using the latest configuration from your booking admin panel. This should resolve the issue of receiving multiple copies of the same email notification.

 

 

 

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 can happen when too many webhooks are activated in your Stripe account for the same post-payment notification URL. To resolve this issue, follow the instructions in the "How to remove and reinstall webhooks in Stripe?" section above.