NAV Navbar

Guide d'installation PrestaShop

Installation

  1. Se rendre sur le backoffice de PrestaShop, puis dans Modules > Catalogues de modules ou Modules & Services (en fonction de votre version)

  2. Chercher le module "alma", puis cliquer sur le bouton "Installer" du module.

    a. Dans PrestaShop 1.7, cliquer ensuite sur le bouton "Configurer" du module

    prestashop_1.7_install

    b. Dans PrestaShop 1.6, vous êtes automatiquement redirigé vers la configuration du module

    prestashop_1.6_install

  3. Entrer les deux clefs d'API (à récupérer sur https://dashboard.getalma.eu/api), laisser en mode "Test" et enregistrer

  4. Aller sur la boutique et ajouter un article à moins de 100€ (ou tout autre seuil minimal défini dans votre contrat) dans le panier

  5. Vérifier qu'il y a bien sous le panier un message indiquant que la commande n'est pas éligible au paiement en plusieurs fois :

    prestashop_ineligible_payment

  6. PrestaShop 1.6 (onepage checkout) : Vérifier que le bouton Alma est désactivé en bas de page (il faut potentiellement cocher les conditions générales) :

    prestashop_not_available

  7. Ajouter un produit dans le panier pour que le montant dépasse le montant maximal défini dans la dashboard

  8. Effectuer les mêmes vérifications #7 et #8

  9. Passer le panier à une valeur comprise entre les montants minimum et maximum autorisés

  10. Vérifier qu'un message apparaît bien sous le panier, indiquant que la commande est éligible au paiement en plusieurs fois :

    prestashop_eligible_payment

  11. Compléter les informations de livraison/facturation

  12. Cliquer sur le bouton Alma / Paiement en plusieurs fois :

    prestashop_available

  13. Une fois la page de paiement chargée, vérifier les informations puis entrer la CB de test

    a. Numéro de carte : 4242 4242 4242 4242

    b. Expiration : 04/42

    c. Code de sécurité : 424

  14. Cliquer sur "Payer", le site doit rediriger vers la boutique après quelques secondes ; la page "confirmation de commande" doit s'afficher

  15. Dans le backoffice, aller dans Commandes et vérifier que la commande est validée :

    prestashop_validated_order

  16. Supprimer/annuler la commande

    prestashop_cancel_order

  17. Revenir à la configuration du module : Modules / Modules et services puis cliquer sur "Configurer" en face du module Alma dans la liste des modules installés.

  18. Ajuster si nécessaire les différents messages qui s'affichent sur le panier, ou bien le titre de la méthode de paiement, etc.

  19. Si le thème de la boutique n'inclut pas de page de confirmation de commande par défaut (i.e. le retour depuis la page de paiement Alma était une page sans contenu), activer l'affichage de la confirmation de commande :

    prestashop_enable_validation_page

  20. Une fois les ajustements effectués, passer le module en mode Live et enregistrer.

FAQ

Comment afficher en premier les mentions concernant Alma (panier éligible ou non) ?

Les messages Alma s'affiche parfois en dessous d'autres informations sous le panier (programme de fidélisation, choix de transporteur, etc.).
Il s'agit généralement d'informations ajoutées par des modules sur le même point d'accroche qu'Alma.
Pour remonter Alma, cliquer sur Apparence (menu de gauche) puis Positions. Rechercher le point d’accroche displayShoppingCartFooter et Drag&Drop le module Alma en première position.

Comment configurer les pays pour lesquels Alma sera affiché ?

Dans l’onglet Paiement (menu de gauche), cliquer sur Préférences. La liste des moyens de paiement ainsi que des pays autorisés apparaît au niveau de Restrictions des pays. Il suffit ensuite de sélectionner les pays souhaités.

prestashop_dom_tom

Comment configurer l’ordre d’affichage des moyens de paiement ?

Dans l’onglet Apparence, cliquez sur Positions. Recherchez “pay” dans la barre de recherche, et affichez les points d’accroche invisibles.

PrestaShop < 1.7 : dans la liste displayPaymentReturn, Drag & Drop les modules dans l’ordre souhaité.
PrestaShop >= 1.7 : dans la liste paymentOptions, Drag & Drop les modules dans l’ordre souhaité.

prestashop_psp_order

Comment personnaliser l’affichage du bouton de paiement Alma ? (PrestaShop < 1.7)

Il faut surcharger le fichier displayPayment.tpl au niveau du thème :

  • Copier /module/alma/views/templates/hook/displayPayment.tpl dans /themes/<thème>/modules/alma/views/templates/hook/displayPayment.tpl
  • Modifier le fichier copié pour l'adapter aux besoins du thème
  • Les variables passées à ce template sont:

    Nom de la variable Description
    $logo Chemin du logo "Alma + logos CB"
    $disabled Le bouton devrait-il être désactivé (Booléen)
    $error Y a-t-il eu une erreur lors de la vérification de l'éligibilité(Booléen)
    $title Titre de la méthode de paiement
    $desc Description de la méthode de paiement
    $order_total Montant total de la commande en euros(Float)

Comment personnaliser l’affichage du bouton de paiement Alma ? (PrestaShop >= 1.7)

Pour PrestaShop 1.7+, les modules de paiement ne font pas eux-mêmes le rendu de leur boutons de paiement, c'est PrestaShop qui le fait. Alma n'échappe pas à la règle et fournit donc des "PaymentOption" à PrestaShop qui se charge d'en faire le rendu. Donc si le marchand a déjà en place un mécanisme pour personnaliser l'affichage de ses moyens de paiement, Alma devrait suivre plus ou moins automatiquement.

Erreurs connues

Alma ne s'affiche pas dans les moyens de paiement lors du checkout Si le message d'éligibilité s'affiche correctement dans le panier mais que le bouton de paiement n'apparaît pas, il est probable qu'Alma n'ait pas été activé pour le transporteur sélectionné pour la livraison.

PrestaShop n'active pas toujours tous les transporteurs par défaut pour un moyen de paiement nouvellement installé.

Solution : se rendre dans Paiement > Préférences, et activer Alma pour tous les moyens de livraison disponibles.

gnutls_handshake() failed: A TLS fatal alert has been received

PHP dans une version trop ancienne, qui a été configurée avec une version obsolète de TLS. TLS 1.2 est requis pour des raisons de sécurité.

La solution est d'installer PHP en version 7.x avec des extensions OpenSSL compatibles avec TLS 1.2.

Affichage message d’éligibilité indue

Si affichage du message d’éligibilité sur la page de confirmation de commande (ou sur tous autres pages qui ne sont pas censées l’avoir) : demander au webmaster de supprimer le point d'accroche ('hook') "displayShoppingCartFooter" de la page concernée.

Le bouton de paiement reste grisé alors que les limites sont correctes : penser à créer les fees plan (en prod et en sandbox)