Ecommerce Templates > Payment Processors > Stripe

Stripe and Ecommerce Templates

Important note for v7.1.3 and above

Stripe have updated their API and from v7.1.3 your Ecommerce Plus templates are compatible with the new SCA (Secure Customer Authentication) compatible integration, and it is highly recommended you use this. Now when you set up Stripe in your Ecommerce Plus admin there is an option "Integration Method", and choose, "New SCA-Ready Stripe Checkout". You also need to create a Webhook. To do this, go to your Stripe.com admin and to do that...

  • 1. Log in to your stripe.com account dashboard
  • 2. In the left hand menu, click on Developers, then Webhooks
  • 3. Click on "+ Add Endpoint"
  • 4. For the Endpoint URL, set it to the location of the page vsadmin/stripewebhook.php (or stripewebhook.asp for the ASP version) in your store. For instance...
  • https://www.yourstoreurl.com/vsadmin/stripewebhook.php
  • 5. Under, "Events to send", just select "checkout.session.completed" under the "Checkout" section.
  • 6. Click, "Add endpoint".

The rest of the setup is the same for both versions.

Stripe and Ecommerce Templates

Once you have created your account with Stripe the first thing you will need to do is open your ecommerce template admin payment providers page. Locate the payment provider listed as "Stripe" and click on the Modify button. Fill in the details as shown below:

Stripe admin

Show As - this is the text that will appear on your checkout for the customer to choose the payment method. You may want to enter the payment provider name or something more generic like "Credit Card".

The Secret Key and Publishable Key are available in your Stripe admin under Your Account > Account Settings > API Keys

To test payments enter the keys Test Secret Key and Test Publishable Key. When you are ready to go live with your store change those to the Live Secret Key and Live Publishable Key.

Enter the name of your store in the Store Name field, this will appear above the payment form on checkout.

For testing purposes use the credit card number 4242 4242 4242 4242 and any expiry date in the future. Other test numbers are available from Stripe.

NOTE - Although payments are taken in a pop up box on checkout for security reasons you should have an SSL certificate installed on your site to accept payments through Stripe. For testing purposes an SSL certificate is not required.

To add your own image or logo to the checkout pop up, make a graphic 128px x 128px, save it as 128x128.png and then upload to the root of your site.