Aero Commerce

Installation

La première étape pour utiliser le plugin est le processus d'installation. Avant de continuer, assurez-vous que votre infrastructure répond à ces exigences système :

Une fois terminé, suivez ces étapes :

```shell
composer require aerocommerce/worldline
```

Configuration

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 de Aero Commerce. Allez dans Configuration > Système > Gérer les paramètres.
2. Cliquez sur Worldline dans la colonne "Nom" du tableau.
3. Configurez les paramètres suivants dans l'onglet "Identifiants Sandbox"/"Identifiants Live" :

   Propriété	Description/Actions
   ID Marchand	Entrez votre PSPID de test/live depuis notre plateforme que vous souhaitez utiliser pour le traitement des transactions.
   API Key	Entrez la API Key de votre PSPID de test/live. Lisez notre guide dédié pour savoir comment en générer une.
   API Secret	Entrez le API Secret de votre PSPID de test/live. Lisez notre guide dédié pour savoir comment en générer un.
   Endpoint	L'API endpoint test/live préconfiguré de notre API Direct. Nous vous conseillons fortement de ne pas modifier cette valeur
   Clé Webhooks	Entrez la clé webhooks de votre PSPID de test/live depuis le Merchant Portal comme décrit dans notre guide dédié.
   Secret Webhooks	Entrez le secret webhooks de votre PSPID de test/live depuis le Merchant Portal comme décrit dans notre guide dédié.
   Nom de fichier du modèle	Entrez le nom du fichier de votre modèle pour adapter "Tokenisation Hébergée (iframe)" ou "Paiement Hébergé (redirection)" pour la propriété "Mode de page de paiement" à l'apparence de votre boutique. Pour savoir comment créer des modèles, consultez nos chapitres dédiés dans les guides Hosted Checkout Page et Hosted Tokenization Page.

4. Configurez les paramètres suivants dans l'onglet inférieur :

   Propriété	Description/Actions
   Délai de traitement des Webhooks (secondes)	Définit la durée minimale (en secondes) avant le traitement des webhooks. Si des clients rencontrent des problèmes pour retourner à votre boutique après avoir finalisé une transaction, le webhook est une sauvegarde pour vous assurer de pouvoir afficher le bon résultat de transaction.
   Activer le Paiement Hybride si Worldline est la seule méthode de paiement disponible	Sélectionnez l'une des options pour définir le processus de paiement : Activé : Vos clients sélectionnent la méthode de paiement sur la page de paiement de votre boutique en ligne. En confirmant la commande, le plugin redirige ensuite vos clients soit : > Vers une version de notre Hosted Checkout Page qui est marquée selon la méthode de paiement sélectionnée. > Le fournisseur tiers proposant la méthode de paiement sélectionnée. Si vous sélectionnez "Tokenisation Hébergée (iframe)" pour la propriété "Mode de la page de paiement", la boutique en ligne affichera l'iframe Hosted Tokenization Page pour les paiements par carte sur la page de paiement de votre boutique en ligne. Vos clients peuvent encore sélectionner toute autre méthode de paiement non carte disponible sur la page de paiement. Désactivé : Vos clients confirment la commande sur la page de paiement de votre boutique en ligne. Le plugin redirige ensuite vos clients vers notre Hosted Checkout Page pour leur permettre de sélectionner leur méthode de paiement préférée. Si vous sélectionnez "Tokenisation Hébergée (iframe)" pour la propriété "Mode de la page de paiement", la boutique en ligne n'affichera que l'iframe Hosted Tokenization Page pour les paiements par carte sur la page de paiement de votre boutique en ligne. Cependant, vos clients ne peuvent pas sélectionner une autre méthode de paiement non carte potentiellement disponible.
   Capturer les fonds immédiatement à la fin de la commande	Définissez si vous souhaitez traiter les transactions en mode d'autorisation ou en Direct Sale. Sélectionnez l'une des options suivantes : Activé : Le montant a été commandé pour être payé en une seule fois. Les transactions réussies auront le statut "CAPTURED" dans le module. Désactivé : Le montant est uniquement bloqué sur la carte de votre client. Utilisez ce mode lorsque vous souhaitez capturer une transaction seulement après l'expédition de la commande. Les transactions réussies auront le statut "AUTHORIZED" dans le module. Si vous désactivez cette option, faites attention à ce qui suit : Assurez-vous de capturer la transaction autorisée ultérieurement. Ce n'est qu'alors que la transaction aura le statut "CAPTURED" dans le module.
   Opérer en mode test (Décochez lors du passage en production)	(Dé)Cochez pour lier votre boutique à l'environnement respectif. Selon votre sélection, le module de la boutique enverra les requêtes de transaction à l'environnement de test ou de production.
   Mode de page de paiement	Sélectionnez l'une des options pour le traitement des paiements : "Paiement Hébergé (redirection)" : Le module traite les méthodes de paiement par carte et non carte via le mode d'intégration Hosted Checkout Page. "Tokenisation Hébergée (iframe)" : Le module ne traite que les paiements par carte via le mode d'intégration Hosted Tokenization Page.
   Regrouper les cartes comme une seule méthode de paiement	Définissez comment les méthodes de paiement par carte sont affichées sur la page de paiement de la boutique en ligne (Paiement Hybride Activé) ou la Hosted Checkout Page (Paiement Hybride Désactivé) : Activé : Regroupez toutes les méthodes de paiement par carte sous une seule catégorie. Désactivé : Indiquez toutes les méthodes de paiement par carte disponibles individuellement.
   Permettre aux clients d'enregistrer les informations de carte	Définissez si vous souhaitez stocker les données de carte de vos clients pour des Card On File payments futurs : Activé : Créez un token pour chaque transaction par carte réussie. Désactivé : Ne pas stocker les données de la carte.
   Icônes des méthodes de paiement	Affiche les méthodes de paiement que vous proposez dans votre boutique en ligne. Ce paramètre n'a pas d'impact sur les méthodes de paiement réellement disponibles. Utilisez les propriétés "Activer le Paiement Hybride si Worldline est la seule méthode de paiement disponible" / "Mode de page de paiement" pour contrôler cela.

5. Cliquez sur "Enregistrer" pour confirmer vos paramètres.
6. Allez dans Modules. Cliquez sur Worldline API Check dans la colonne "Nom" du tableau pour confirmer et valider vos paramètres en établissant une connexion de test entre le plugin et notre plateforme. Vérifiez que dans le tableau "Résultat du test" il soit indiqué "Succès". Sinon, contactez votre administrateur système pour résoudre le problème et vérifier :
   a. Vous utilisez les identifiants corrects
   b. Si votre PSPID est actif

Configurer les méthodes de paiement

1. Connectez-vous au Back Office de Aero Commerce. Allez dans Configuration > Méthodes de paiement
2. Cliquez sur "+ Nouvelle méthode de paiement" et configurez les paramètres suivants :

   Propriété	Description/Actions
   Nom	Ajoutez un nom pour vous référer à ce module dans le plugin.
   Driver	Sélectionnez "worldline" dans le menu déroulant.
   Disponible	Cochez pour rendre ce module disponible dans le processus de paiement. En définissant cette propriété, toutes les méthodes de paiement (carte et non carte) actives de votre compte Worldline sont disponibles dans le processus de paiement.
   Ordre	Définissez la position du module dans la liste des méthodes de paiement disponibles sur la page de paiement de la boutique en ligne.

3. Cliquez sur "Enregistrer" pour confirmer vos paramètres.

Gérer les paiements

Nous avons conçu le plugin pour suivre facilement vos commandes, vous libérant ainsi de l'administration impliquée. Découvrez ici comment utiliser notre plugin efficacement, ce qui pourrait aider votre entreprise à prospérer !

Effectuer des remboursements

Le remboursement est un processus standard dans votre logique commerciale quotidienne. Découvrez ici comment les effectuer directement dans le Back Office de Aero Commerce :

1. Connectez-vous au Back Office de Aero Commerce. Allez dans Gestion des commandes > Commandes.
2. Dans la vue d'ensemble des commandes, cliquez sur la commande dans le tableau.
3. Cliquez sur "+ Nouveau retour / Remboursement" et remplissez "Quantité" et "Remboursement %" pour un remboursement (partiel).
   Veuillez noter que vous ne pouvez rembourser que les transactions ayant le statut "CAPTURED". Si vous essayez de rembourser une transaction ayant le statut "AUTHORIZED", la vue d'ensemble des commandes affichera le message "Il y a des paiements non capturés pour cette commande. Les remboursements ne peuvent être effectués que sur des paiements capturés."
4. Cliquez sur "Enregistrer" pour confirmer l'opération.

Effectuer des transactions de test

Utilisez l'environnement de test 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 le chapitre "Configurer le plugin".