vendredi, octobre 07, 2022
Text Size

Stripe pour 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.

Informations du plug-in

'Download ID' pour Mises à jour Automatiques 'Download ID' pour Mises à jour Automatiques

Le 'Download ID' est généré par votre souscription avec Puma-IT.
Vous pouvez le trouver dans l'e-mail de confirmation et dans la page My Subscriptions sur https://www.puma-it.ie/en/my-account (en anglais)

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

BASIC PARAMETERS

Mode de paiment Stripe Mode de paiment Stripe
Test | Live

Paramètres de Test Stripe

Stripe Test Secret Key Stripe Test Secret Key
Stripe Test Publishable Key Stripe Test Publishable Key
En Mode Test, afficher numéros de Test de cartes de paiement ? Affiche les numéros de Test de cartes de paiement dans le formulaire de paiement

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

Paramètres de Production Stripe (Live)

Stripe Live Secret Key Stripe Live Secret Key
Stripe Live Publishable Key Stripe Live Publishable Key
Reçu par e-mail Stripe 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
Ceci n'est PAS l'e-mail de confirmation envoyé par VirtueMart, mais un reçu de paiement par e-mail, envoyé par Stripe.com.
Les reçus ne seront PAS envoyés pour les transactions en mode Test.
 

A sample receipt, customisable in Stripe Dashboard

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

Pour plus de détails, merci de consulter la documentation sur Stripe.com (en anglais) : https://support.stripe.com/questions/email-receipts

ADDITION: about "Email Receipts" in documentation + reformat

[FR TODO] Configuration v2.2.0 b thumb

Paramètres Stripe.com

Cette section définit comment va se comporter le compte Stripe.com.

Prise en charge de 3D Secure
Depuis v2.2.0
3D Secure fournit un niveau de protection contre les paiements frauduleux qui est pris en charge par la plupart des organismes émetteurs de cartes. Contrairement aux paiements par carte ordinaires, 3D Secure exige que les titulaires de cartes effectuent une étape de vérification supplémentaire auprès de l'émetteur. Les utilisateurs sont couverts par un transfert de responsabilité contre les paiements frauduleux qui ont été authentifiées avec 3D Secure car l'émetteur de la carte assume l'entière responsabilité.
Désactivé [FR TODO - look into Content .ods] 3D Secure is disable and transactions are processed like regular card payments, ignoring 3D Secure options.
Activé (uniquement lorsque 3DS est requis) 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.
Exigé (lorsque 3DS est optionnel) 3D Secure is enabled when it is required AND optional by the card issuer.

[FR TODO] Here is a checkout example with a default template (frontend):

Checkout example Animated GIF

Paramètres du plug-in Stripe

Devise du paiement Devise du paiement
Cartes de paiement acceptées Sélectionner les cartes de paiement que vous souhaitez accepter
Afficher la liste des cartes de paiement acceptées Option pour changer la manière dont la liste des cartes de paiement est affichée.
Masquer par défaut, car Stripe reconnaît automatiquement le type de carte de paiement depuis son numéro.
Paramètre par défaut VirtueMart affiche une liste déroulante.

Paramètres Statuts commandes

Transactions en attente Statut des commandes dont le règlement est en attente, mais n'a pas été annulé
Transactions réussies Sélectionnez le statut des commandes dont le paiement Stripe est terminé. Si des produits téléchargeables sont concernés, sélectionnez le statut activant la possibilité de téléchargement (l'acheteur sera immédiatement informé par e-mail de l'adresse de téléchargement).
Transactions refusées Sélectionnez le statut des commandes dont le paiement Stripe a été refusé.

Options de Template

Logos Logos à afficher avec le nom du paiement
Chemin du dossier des images : '/images/stories/virtuemart/payment'
Images CVV Images CVV qui seront ajoutées à l'info-bulle 'Qu'est-ce que le Numéro de sécurité (CVV) ?'
Chemin du dossier des images : '/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.

Paramètres Avancés

Type de 'Stripe Charge' Different types d'implémentation de 'Stripe Charge' :
Stripe.js : JavaScript pour générer un 'token' (réglage par défault).
Direct : méthode 'Charge' sans obligation de 'token' (mieux pour un processus de commande différent de celui par défaut).

PARAMETRES OPTIONNELS

Restrictions

Activer des filtres pour désactiver l'option de paiement.
Montants dans la devise du vendeur.

Pays Merci de sélectionner le pays pour lequel ce mode de paiement s'applique. Si aucun pays n'est sélectionné, ce mode de paiement sera appliqué pour tous les pays.
Montant minimum Montant minimum de commande pour proposer ce paiement
Montant maximal Montant maximum de la commande pour proposer ce paiement
Début de publication du paiement Date optionnelle pour commencer à proposer ce paiement. Laisser vide pour éviter cette restriction.
Fin de publication du paiement Date optionnelle pour cesser de proposer ce paiement. Laisser vide pour éviter cette restriction.
Autoriser Stripe seulement pour certaines livraisons Laisser vide pour éviter cette restriction.

Réductions et frais

Réductions et frais à appliquer si le paiement est sélectionné.

Frais par transaction Montant forfaitaire à appliquer par transaction
Pourcentage sur Montant total produits Pourcentage à appliquer sur le Montant total des produits. Le coût de la livraison n'est pas inclus.
Taxe TVA à appliquer sur les frais

 

Forcer jQuery pour le plug-in Stripe Désactiver par défaut pour éviter certains problèmes avec JavaScript, mais peut-être utile dans une configuration spécifique.

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!.

Horaires du Support Technique

Nos heures d'ouverture sont du Lundi au Vendredi de 10:30 à 18:30 heure française (09:30 – 17:30 heure d'éte irlandaise (GMT+1). Voir notre heure locale.
Le système de ticket est fermé les week-ends et en dehors de ces jours: vous ne pouvez ni ouvrir un nouveau ticket, ni répondre à ceux déjà ouverts.

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.

Extensions et Services en français

Nous ajoutons, progressivement, la version française des pages et interactions concernant le plugin Stripe pour VirtueMart. Certaines parties sont encore en anglais, merci de votre patience !

Commentaires sur Stripe pour 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!