Stripe pour VirtueMart & Joomla!
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.
- Instructions and first set-up
- Configuration
- Informations du plug-in
- BASIC PARAMETERS
- Paramètres de Test Stripe
- Paramètres de Production Stripe (Live)
- Paramètres Stripe.com
- Paramètres du plug-in Stripe
- Paramètres Statuts commandes
- Options de Template
- Paramètres Avancés
- PARAMETRES OPTIONNELS
- Restrictions
- Réductions et frais
- Credit card form Styling and CSS
- How to change the style and CSS for the inputs (credit card number, expiration date, CVV) ?
- How to hide the card form when the Stripe payment method is not selected?
- Why are the labels and entry fields not aligned?
- Why is the CVV image Tooltip not visible?
- SSL/TLS and Stripe
- Troubleshooting
Instructions and first set-up
- Install the Stripe plugin for VirtueMart like any Joomla extension
- Enable it in Joomla plugin manager
- Go to VirtueMart > Payment methods
- Click New and select VM - Payment, Stripe
- Name it like "Credit Card or Debit Card via Stripe secure server" and Save to enable the configuration tab
- 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. - 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. |
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 |
Les reçus ne seront PAS envoyés pour les transactions en mode Test.
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 + reformatParamè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):
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:
You can also find more Stripe images on the official Stripe graphical resources.
For more information about this feature, please read the VirtueMart documentation.
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!.