PrestaShop

Avant de procéder au processus d'installation, assurez-vous que votre infrastructure répond à ces exigences système :
Compatibilité :

Téléchargements :

Autres exigences :

La première étape nécessaire à l'utilisation du plugin est son installation. Avant de procéder, assurez-vous que votre infrastructure réponde à ces exigences :

Une fois terminé, suivez ces étapes :

1. Connectez-vous au Back Office PrestaShop. Allez à IMPROVE > Modules > Modules catalog. Cliquez sur "Upload a module" et téléchargez le fichier zip.
2. Le processus d'installation commence automatiquement. Une fois terminé, vous pouvez configurer le plugin.
3. Cliquez sur le bouton "Configure" pour commencer le processus de configuration. Cette page vous permet de configurer les paramètres génériques de la boutique, notamment si vous la mettez en place dans un contexte de "multiboutiques".

Si vous souhaitez plutôt installer le module via FTP, suivez ces étapes :

1. Décompressez le fichier zip du module PrestaShop.
2. Téléchargez l'ensemble du fichier "worldlineop" via FTP dans le repository de fichiers <yourdomain>/modules.
3. Connectez-vous au Back Office PrestaShop. Allez à IMPROVE > Modules > Modules catalog. Recherchez "Worldline Global Online Pay" dans la barre de recherche.
4. Le module apparaît comme résultat de recherche. Cliquez sur le bouton "Install" pour poursuivre le processus d'installation.

Après l'installation, vous devez configurer le plugin pour lier votre boutique à notre plateforme.

Configurer les paramètres de base

1. Connectez-vous au Back Office PrestaShop. Allez à IMPROVE > Modules > Module Manager > Payment. Cliquez sur "Configure" à côté de "Worldline Global Online Pay".
2. Allez dans l'onglet "MY ACCOUNT" et configurez les paramètres suivants :

   Propriété	Description/Actions
   Environnement	Sélectionnez 'Test' ou 'Production' pour lier votre boutique à l'environnement correspondant. En fonction de votre sélection, le module de la boutique enverra les demandes de transaction à l'environnement de recette ou de production. Assurez-vous de Ne pas mélanger les identifiants de recette avec ceux en production et vice versa lors de la configuration des champs PSPID/API et des identifiants des webhooks. Passer en 'Production' dès que vous avez finalisé vos tests.
   PSPID Test/Prod	Entrez le PSPID que vous souhaitez utiliser pour le traitement des transactions.
   API Key Test/Prod	Entrez l'API Key de votre PSPID de recette ou de production. Lisez notre guide dédié pour apprendre comment en générer une.
   API Secret Test/Prod	Entrez l'API Secret de votre PSPID de recette ou de production. Lisez notre guide dédié pour apprendre comment en générer un.
   Clé Webhooks Test/Prod	Entrez la clé webhooks de votre compte de recette ou de production comme décrit dans notre guide dédié.
   	Entrez le secret webhooks de votre compte de recette ou de production comme décrit dans notre guide dédié.
   URL des Webhooks	Copiez cette URL dans les champs d'endpoints URL de votre compte comme décrit dans notre guide dédié.

1. Cliquez sur "Save" si vous souhaitez simplement conserver vos identifiants. Cliquez sur "Save & Check credentials". Assurez-vous que le message "Account credentials are valid. Account settings saved successfully." s'affiche.
2. Allez à IMPROVE > Payment > Preferences. Associez Worldline Global Online Pay avec les groupes d'utilisateurs, les transporteurs, les pays et les devises selon vos besoins métier.
3. Allez à CONFIGURE > Advanced parameters > Email. Si vous souhaitez envoyer des e-mails de confirmation de commandes, assurez-vous que PrestaShop les envoie correctement. Utilisez "Test your email configuration" pour cela.

Votre plugin est maintenant prêt à accepter les paiements sur notre plateforme !

Si vous souhaitez effectuer des personnalisations avancées pour optimiser l’expérience de paiement de vos clients, consultez notre paragraphe dédié sur ce qui est possible. Avez-vous rencontré des problèmes lors du processus d'installation/configuration ? Consultez notre paragraphe de dépannage dédié.

Configurer les paramètres avancés

Nous avons conçu notre plugin PrestaShop pour vous garantir un moyen rapide et facile d'accepter des transactions. Les paramètres suivants sont optionnels, mais vous pourriez les utiliser pour optimiser l’expérience de paiement de vos clients et l'adapter à vos exigences métier.

Pour ce faire, suivez ces étapes :

1. Connectez-vous au Back Office PrestaShop. Allez à IMPROVE > Modules > Module Manager > Payment. Cliquez sur "Configure" à côté de "Worldline Global Online Pay ".
2. Assurez-vous que "Show advanced settings" est réglé sur YES. Allez dans l'onglet "ADVANCED SETTINGS" et configurez les paramètres suivants :
   
   

   Propriété	Description/Actions
   Type de transaction	Définissez si les transactions doivent être traitées en mode Authorisation ou Direct Sale. Sélectionnez l'une des options suivantes : Immediate (Autorisation + Capture) : Le montant a été demandé pour être payé en une seule fois. Utilisez ce mode pour recevoir l'argent avant l'expédition de la commande. Il n'y a aucune autre action requise pour capturer la transaction. Les transactions réussies auront statut=""CAPTURED"" / statusOutput.statusCategory=""COMPLETED"" / statusOutput.statusCode=9 Authorized (Autorisation uniquement) : le montant est seulement bloqué sur la carte de votre client. Les transactions réussies auront statut=""PENDING_CAPTURE"" / statusOutput.statusCategory=""PENDING_MERCHANT"" / statusOutput.statusCode=5 (Utilisez ce mode lorsque vous souhaitez capturer une transaction uniquement après l'expédition de la commande) Si vous sélectionnez "Authorized", configurez également les éléments suivants : Delay before payment capture : Vous pouvez définir le délai de capture à X jours dans le champ donné. À l'issue de cette durée, une tâche automatisée capturera automatiquement la transaction. Si la transaction a déjà été partiellement capturée entre-temps, tous les fonds restants disponibles seront capturés. Capture cronjob : Copiez la commande cron du plugin et collez-la dans le PrestaShop core pour qu'elle s'exécute automatiquement. Si le type de transaction est réglé sur "Authorized", soyez conscient des éléments suivants : Assurez-vous de capturer la transaction autorisée plus tard. Ce n'est que lorsque la transaction aura statut=""CAPTURED"" / statusOutput.statusCategory=""COMPLETED"" / statusOutput.statusCode=9, que vous recevrez le paiement réel de la transaction. Même si le délai de capture est réglé sur X jours, vous pouvez également capturer manuellement des fonds totalement / partiellement en ouvrant une commande une fois que vous avez délivré les biens/services.
   Activer le logging avancé	Si vous êtes en mode debug et avez besoin de logs supplémentaires pour le dépannage, activez ce paramètre. Téléchargez tous les logs disponibles ici-même.
   Modification de la cinématique de paiement	Nous recommandons fortement de laisser les paramètres tels quels pour garantir un traitement sécurisé des transactions : Payment accepted status mapping : Mappez les statuts de transaction réussis selon vos besoins métier. Pending payment status mapping : Mappez les statuts de transaction en attente selon vos besoins métier. Payment error status mapping : Mappez les statuts de transaction non réussis selon vos besoins métiere. Release inventory from Pending payment orders after : Pour toutes les commandes dans un statut inconnu, sélectionnez la période après laquelle une tâche automatisée automatique supprimera la commande dans PrestaShop et sur notre plateforme. Pending Order Cronjob : Copiez la commande cron du plugin et collez-la dans le PrestaShop core pour qu'elle s'exécute automatiquement. Force 3DsV2 : (Dés)activez la vérification 3-D Secure. Nous recommandons fortement de le régler sur YES pour éviter un taux élevé de transactions refusées. Ce mapping concerne uniquement les statuts de transaction PrestaShop. Les statuts de Direct ne sont pas affectés par ce paramètrage.

3. Cliquez sur "Save" pour confirmer vos paramètres.
4. Allez dans l'onglet "PAYMENT METHODS" et configurez les paramètres suivants :

1. Cliquez sur "Save" pour confirmer vos paramètres.

L'image ci-dessus illustre la personnalisation du texte du bouton radio sur la page de paiement PrestaShop.

L'image ci-dessus illustre la présence d'un logo téléchargé tel qu'il apparaît sur la page de paiement PrestaShop.

Dépannage des erreurs

Si vous rencontrez des problèmes lors du processus d'installation/configuration ou lors de l'utilisation du plugin, consultez la liste suivante pour vous aider :

• Utilisez la fonction de logging standard de PrestaShop (CONFIGURE > Advanced Parameters > Logs) pour résoudre les problèmes liés aux droits d'accès des utilisateurs et aux délais d'attente.
• Activez le mode debug via CONFIGURE > Advanced Parameters > Performance > Debug mode pour obtenir plus d'informations sur les erreurs rencontrées.
• Obtenez des logs supplémentaires via IMPROVE > Modules > Module Manager > Payment > ADVANCED SETTINGS > Payment Settings > Enable advanced logging.
• Vérifiez que le module est correctement intégré en cas d'éléments manquants ou dysfonctionnels dans le Back Office ou le Front Office de PrestaShop. Allez à IMPROVE > Design > Positions. Sélectionnez "Worldline Global Online Pay" dans le menu déroulant "Show" pour confirmer que :
  • "Display non-positionable hooks" est coché.
  • La liste des hooks suivants est présente.
    
    actionAdminControllerSetMedia
    actionFrontControllerSetMedia
    actionOrderStatusPostUpdate
    customerAccount
    displayAdminOrderLeft
    displayAdminOrderMainBottom
    displayBackOfficeFooter
    displayHeader
    displayPaymentByBinaries
    displayPaymentTop
    displayPDFInvoice
    orderConfirmation
    paymentOptions
    
    Si un hook est manquant, allez à IMPROVE > Design > Positions. Sélectionnez "Worldline Global Online Pay" dans le menu déroulant "Module" et ajoutez le hook manquant dans le champ "Transplant to".

Nous avons conçu le plugin pour traiter vos commandes automatiquement et de manière autonome, vous libérant des tâches administratives nécessaires. Apprenez ici comment utiliser efficacement notre plugin, ce qui pourrait aider votre entreprise à prospérer !

Effectuer des opérations de maintenance

Les captures, remboursements et annulations d'autorisation sont des processus standards (opérations de maintenance) dans votre fonctionnement quotidien. Apprenez ici comment effectuer ces opérations directement dans le Back Office PrestaShop :

• Connectez-vous au Back Office PrestaShop. Allez à Sell > Order Settings > Order Settings. Cliquez sur la commande dans la liste.
• Dans l'aperçu de la commande, allez dans "Worldline Global Online Pay". Selon le statut actuel de la transaction, vous pouvez capturer/annuler/rembourser en cliquant sur le bouton correspondant.

Effectuer des transactions de test

Utilisez l'environnement de recette de notre plateforme pour vous assurer que votre plugin fonctionne comme prévu. Nous proposons des ensembles de données de test sur notre page dédiée Cas de test. Ciblez notre environnement de test comme décrit dans la section "Configurer le plugin".