Friday, November 15, 2019
Text Size

Stripe for VirtueMart & Joomla!

image

Stripe for VirtueMart 2 & 3 / Joomla 2.5 & 3.x

We provide free documentation for our extensions, accessible for everyone to read. Please make sure that your question is not answered in the documentation below before submitting a ticket for support. It will save you time! Feel free to suggest us any improvements, or detail missing.

Configuration v2.2.0 a close up

 

Instructions and first set-up

  1. Install the Stripe plugin for VirtueMart like any Joomla extension
  2. Enable it in Joomla plugin manager
  3. Go to VirtueMart > Payment methods
  4. Click New and select VM - Payment, Stripe
  5. Name it like "Credit Card or Debit Card via Stripe secure server" and Save to enable the configuration tab
  6. In the Configuration tab, add your Stripe settings and Save
    Please note both Stripe Test Secret Key and Stripe Test Publishable Key are required to test a transaction. It will failed otherwise.
  7. Publish the Payment Method and Save & Close

Configuration

Here is an overview of the available Configuration settings. All descriptions are available in the tooltips of the options.

Plugin Information

Download ID For Automatic Updates Download ID For Automatic Updates

The Download ID is generated with your subscription with Puma-IT.
You can retrieve it from the confirmation email and on the My Subscriptions page at https://www.puma-it.ie/en/my-account

If you bought your plugin through the VirtueMart Extensions Directory (VMED) please contact us to get your Download ID.
 

BASIC PARAMETERS

Stripe Payment Mode Stripe Payment Mode
Test | Live

Stripe Test Parameters

Stripe Test Secret Key Stripe Test Secret Key
Stripe Test Publishable Key Stripe Test Publishable Key
In Test mode, display credit cards numbers? Display credit cards Test numbers within the payment form

Stripe will provide you with an easy test setup before going live. For your convenience, there is an option to display some card Test numbers within the payment form.

For more testing, here are some test cards to simulate transactions:
https://stripe.com/docs/testing#cards

Stripe Live Parameters

Stripe Live Secret Key Stripe Live Secret Key
Stripe Live Publishable Key Stripe Live Publishable Key
Stripe Email Receipt The email address used is the Billing Address email (BT). The receipt will not be sent until the charge is paid.
If this option is enabled for a charge in live mode, a receipt will be sent regardless of your email settings in Stripe Dashboard:
https://dashboard.stripe.com/account/emails
This is NOT the confirmation email sent by VirtueMart, but a Payment receipt email, sent by Stripe.com.
Receipts will NOT be sent for test mode charges.
 

A sample receipt, customisable in Stripe Dashboard

Customise your email receipts
https://dashboard.stripe.com/account/public

For more details, please check the Stripe.com documentation
https://support.stripe.com/questions/email-receipts

Configuration v2.2.0 b thumb

Stripe Account Settings

This section defines how your Stripe.com account will behave.

3D Secure support
Since v2.2.0
3D Secure provides a layer of protection against fraudulent payments that is supported by most card issuers. Unlike regular card payments, 3D Secure requires cardholders to complete an additional verification step with the issuer. Users are covered by a liability shift against fraudulent payments that have been authenticated with 3D Secure as the card issuer assumes full responsibility.
Disabled 3D Secure is disable and transactions are processed like regular card payments, ignoring 3D Secure options.
Enabled (only when 3DS Required) 3D Secure is enabled only when it is required by the card issuer. If 3D Secure is optional for a card, transactions are
processed like regular card payments.
Requested (when 3DS Optional) 3D Secure is enabled when it is required AND optional by the card issuer.

Here is a checkout example with a default template (frontend):

Checkout example Animated GIF

Stripe Plugin Parameters

Payment Currency Currency accepted for the payment
Accepted Credit Cards Select Your Accepted Credit Cards
Display Accepted Credit Cards Type List Option to change the way the Credit Cards list is displayed.
Default is Hide, as Stripe recognises automatically the credit card type from the number.
VirtueMart default displays a select dropdown list.

Order Status Parameters

Pending transactions The order status to which orders are set, which have no completed Payment Transaction. The transaction was not cancelled in this case, but it is just pending and waiting for completion.
Successful transactions Select the order status to which the actual order is set, if the Stripe Payment was successful. If using download selling options: select the status which enables the download (then the customer is instantly notified about the download via e-mail).
Order Status for Failed transactions Select an order status for Failed Stripe transactions.

Template Options

Logos Logos to be displayed with the payment name
Image Path: '/images/stories/virtuemart/payment'
CVV images CVV images that will be added to the tooltip 'What is CVV?'
Image Path: '/images/stories/virtuemart/payment'

For you convenience, here are few images that you can freely download and use for your website:mc visa amex disco stripe dark solid
mc visa amex disco
mc visa amex stripe dark solid
mc visa amex

You can also find more Stripe images on the official Stripe graphical resources.
For more information about this feature, please read the VirtueMart documentation.

Advanced Parameters

Stripe Charge Type Different type of Charge implementations:: Stripe.js: JavaScript to generate a token :: Direct: Charge method without token requested (better with non default checkout).

OPTIONAL PARAMETERS

Restrictions

Fill out filters to disable the payment option based on customer and his cart.
Amount is based on the vendor currency.

Countries Please select the countries for which this payment method applies. If no country is selected, this payment method will be applied for all countries.
Minimum Amount Minimum Order Amount to offer this Payment
Maximum Amount Maximum Order Amount to offer this Payment
Payment publish start Select a date to start offering this payment method. Leave empty to skip restriction.
Payment publish end Select a date to start offering this payment method. Leave empty to skip restriction.
Allow Stripe only for certain shipments Leave empty for any shipment.

Discounts and Fees

Enter discounts or Fees that will be applied when the payment option is selected.

Fee per transaction Flat amount to apply per transaction
Percent of the total product amount Percent to apply to the total product amount. Shipment cost are not included.
Tax Tax to apply to the fee

 

Force jQuery for Stripe plugin Disable by default to avoid some JavaScript issues, but may be useful in specific setup.

Credit card form Styling and CSS

The plugin is using the regular VirtueMart credit card form. The rest depends on the Joomla/VM template to render fields, form, buttons, etc.. So we suggest to use a custom CSS file, with all the style overrides. There is probably one with the template, that you may have already used for further customisations. You should use a browser inspector to help.

Please note that these are only general suggestions on HTML and CSS design. Further customisation are out of the scope of our plugin support.

How to change the style and CSS for the inputs (credit card number, expiration date, CVV) ?

You can add some CSS like this:

.vmpayment_cardinfo { your CSS rules;}

this is from the VirtueMart file vm-ltr-site.css, and you can style down the following tags:

.vmpayment_cardinfo table tr td label, select, input, etc...

How to hide the card form when the Stripe payment method is not selected?

It is possible to hide the input area, but not directly within the plugin settings. It is on our todo list though. You may try some CSS as well, like suggested by one of our clients:

#payment_id_XX + label + br + div + span {
display: none;
}
#payment_id_XX:checked + label + br + div + span {
display: block;
}

where payment_id_XX should be replaced by the payment ID of your website.

Why are the labels and entry fields not aligned?

The style really depends on the template first, and on the VirtueMart default styling. Alignment can be done with CSS again.

Why is the CVV image Tooltip not visible?

The CVV image should be visible, but the tooltip style depends on a JavaScript injected by VM in the of the page. There could be several reasons why it is not the case, according to your set up.

SSL/TLS and Stripe

This information is taken from Stripe.com help section. Please read it carefully here https://stripe.com/help/ssl

SSL (Secure Sockets Layer) and TLS (Transport Layer Security) are mechanisms for safely transmitting data.

Do I need to use SSL/TLS on my payment pages?

Yes, for a couple of reasons:

  • It's more secure. In particular, it significantly reduces your risk of being exposed to a man-in-the-middle attack.
  • Users correctly feel more comfortable sharing their payment information on pages visibly served over HTTPS. Your conversion rate is likely to be higher if your pages are served over SSL/TLS, too.

What if I don't want to set up SSL/TLS yet?

  • You can test your page--but not live transactions--before installing your SSL/TLS certificate. You don't need to enable HTTPS until you're ready to go live.
  • To test live transactions without your own SSL/TLS certificate, you could host your site with a provider that provides a secure subdomain.

For more details, please logon to https://stripe.com/help/ssl.

Troubleshooting

Please read our page Troubleshooting Stripe for VirtueMart & Joomla!.

Support Hours

Our opening hours are Monday to Friday 09:30 – 17:30 Irish Time (GMT). See our local time.
The ticket system is closed on weekends and outsides these days: you can neither file new tickets or reply to existing ones.

The Joomla! ® name is used under a limited license from Open Source Matters in the United States and other countries. Puma-IT is not affiliated with or endorsed by Open Source Matters or the Joomla! Project.

Popular Joomla Posts

Stripe for Joomla & VirtueMart: SCA and PSD 2, Questions and Answers

With the Strong Customer Authentication (SCA) deadline falling on Saturday, 14 September 2019, we received a lot of questions...

Reviews for Stripe for VirtueMart

star starstarstar star 
Functionality

Once you go through the documentation and try out the settings (and don't forget to test it with a "test item", it works like a dream.

Ease of use

Very easy to use, though a little play with the settings may be needed to get an understanding of the system. And you need a stripe account.

Support

Best support ever. Hervé has been very patient and kind and helped me greatly when the Stripe plugin no longer spoke with the new updates.

Documentation

Documentation is very good. You do need a Stripe account, and you need a little "try out" time to get it all in place.

Value for money

Yes, very much value for money. The plugin, Hervé's support, the easy for the customers to use it. It is all worth it.

I used this to: I use it for my IMRF Bookshop: imrfbookshop(.)org. People can now pay by credit/debit card, Paypal (different plugin) and they can request an invoice and pay by bank transfer.
Owner's reply: Thanks a Million for your excellent review! This means a lot to me. And on a early Tuesday morning, you not only you made my day, but you made my whole week! Please accept my sincere gratitude for your feedback and for your trust in my services.
star starstarstarstar 
Functionality

I particularly liked that test and live config is entered once, and a radio button to switch between modes

Ease of use

Straight forward to setup in the backend and easy for customers to use on the frontend.

Support

Issues created by an upgrade to Virtuemart were dealt with in a timely manner by the developer.

Documentation

Good documentation library that uses screen shots to clearly show configurations

Value for money

Yes. There are different subscription options, depending on your requirements.

I used this to: Selling various items of merchandise for a sailing club through Virtuemart.
Owner's reply: Thank you so much Lee! I am very grateful for your review and support!

Easy

15 February 2019
star starstarstarhalf star 
Functionality

Covers all what I need

Ease of use

Very simple installation and very simple tu use it

Support

Excellent !

Documentation

Nearly good

Value for money

Sure !

Owner's reply: I am really thankful for your review on the JED ! Our Documentation has been improved now, also with the addition of Styling and CSS help. Soon it will be available in several languages!
star starstarstarstar 
Functionality

Excellent, very easy to integrate and works well with the OPC we use from Virtueplanet.

Ease of use

Customer simply sees a neat credit card form

Support

Excellent, fast and comprehensive

Documentation

Simple to follow

Value for money

Very competitively priced, license is simple - use on as many domains as you like

I used this to: Multiple ecommerce websites
Owner's reply: Thanks a million Sharkey Consulting! I am very appreciative of your support!
star starstarstarstar 
Functionality

Excellent - does everything we need

Ease of use

Very easy to use, configuration is easy

Support

Excellent - 200 out of 100 if I could :) Herve helped with any queries super quickly

Documentation

We didn't need to use it - the online help was perfect

Value for money

Excellent value, great extension for our needs

I used this to: Selling academic residential conferences
Owner's reply: Thanks a million David! I am very grateful for your appreciation!
star starstarstarstar 
Functionality

It works good and easy with OPC.

Ease of use

Very easy to install.

Support

I had a problem and it was solved fast.

Documentation

Enough

Value for money

good

I used this to: VM shop
Owner's reply: ¡Muchas gracias! I really appreciate your feedback!
star starstarstarstar 
Functionality

Works perfectly.

Ease of use

Very easy to use.

Support

Great support! There were some issues with the template we are using, but Hervé was very helpful and competent to find a solution!

Documentation
Value for money

Absolutely worth the money.

I used this to: An Italian online tea shop.
Owner's reply: Thank you very much for your great review, It means a lot to me!
star starstarstarstar 
Functionality

Functioned perfectly

Ease of use

Easy to use.

Support

Excellent support. Herve installed. Worked perfectly the first time.

Documentation

Easy to understand

Value for money

Worth more... great value.

I used this to: Our Shopping Cart Products on our Website
star starstarstarstar 

This plugin is great! At first I couldn't get it to work with my install of joomla and virtuemart--but the great tech support from Puma-it (Herve) did real right by me, helping me to quickly resolve the problem and get this up and working on my site. Thanks Herve for your great Code and keep up the great work!

Owner's reply: Thank you Sethtc for sharing your review on my plugin and support services! That is the first review, so I feel very proud. Serving our customers as best as we can is rewarding, I know it!