Frisbii Shopware Extension

Guide d'installation du plugin Frisbii Shopware

Ce guide vous accompagne dans l'installation et l'utilisation du plugin Frisbii pour Shopware. Frisbii apporte à votre boutique Shopware de puissantes fonctionnalités de facturation et de paiement récurrents, vous permettant de vendre des produits par abonnement, de gérer les renouvellements, d'appliquer des remises, et bien d'autres choses encore.

Que vous soyez débutant ou que vous cherchiez à optimiser vos offres d'abonnement, ce guide vous aidera :

Installer et configurer le plugin Frisbii
Activer et personnaliser les modes de paiement
Mise en place de produits et de règles d'abonnement
Gérer les add-ons, les options clients et les coupons

ℹ️ Note : Avant de procéder, assurez-vous d'avoir un compte Frisbii et d'avoir accès à vos clés API. Vous en aurez besoin au cours de la procédure d'installation.

Style et personnalisation

Toutes les captures d'écran de ce guide montrent la version par défaut, non stylisée, de l'intégration Frisbii. Toutefois, le contenu et la présentation de la boutique en ligne peuvent être entièrement personnalisés pour s'adapter à la conception de votre boutique en ligne. Les textes et les traductions peuvent être modifiés via Admin → Settings → Snippets, et les modèles peuvent être modifiés par votre développeur comme n'importe quel autre modèle de Shopware. Vous pouvez également enrichir les pages destinées aux clients avec des données supplémentaires provenant de l'API Frisbii, si nécessaire.

1. Installer le plugin Frisbii

Commencez par installer le plugin officiel Frisbii depuis la boutique Shopware : Frisbii pour Shopware

Frisbii permet des paiements et des abonnements sécurisés, prend en charge plusieurs modes de paiement et offre une gestion de la facturation récurrente.

Conseil : L'installation via le Shopware Store vous permet de toujours bénéficier de la dernière version testée et d'options de mise à jour automatique.

2. Localiser et configurer le plugin

Après l'installation, naviguez vers Extensions → My Extensions et localisez le plugin Frisbii.

Cliquez sur Configure pour ouvrir les paramètres du plugin.

Configuration de l'API Frisbii

Private API Key/Webhook Secret: Collez vos informations d'identification à partir du tableau de bord Frisbii.
Cliquez sur Install webhooks in Frisbii pour activer les mises à jour en temps réel.

⚠️ Important : Les webhooks sont nécessaires pour synchroniser les événements tels que les mises à jour de l'état des paiements et les renouvellements d'abonnement entre Frisbii et Shopware.

Frisbii Payment Configuration

Send transactions : Lorsque cette option est activée, le plugin n'envoie que le montant total de la commande à Frisbii, sans détailler les différentes lignes de la commande. Lorsque cette option est désactivée, toutes les lignes de commande provenant de Shopware sont envoyées à Frisbii.
Send shipping costs: Si le paramètre Send transactions est désactivé, Shopware envoie chaque produit comme une ligne de commande séparée à Frisbii. L'activation de ce paramètre garantit que les frais d'expédition sont inclus dans une ligne de commande supplémentaire.
Update Frisbii invoice when changing Shopware payment status : Maintenir la synchronisation des factures entre les systèmes. Les remboursements, les annulations et les règlements effectués dans Shopware seront répercutés dans Frisbii.

Frisbii Billing Configuration

Enable Cancellation of Subscriptions : Permet aux clients de résilier et de réactiver des abonnements à partir de "Mon compte".
Enable Pausing of Subscriptions : Ajoute des options de pause et de reprise pour les clients.
Enable Creation of Renewal Orders in Shopware : Indispensable si vous expédiez des biens physiques avec des renouvellements.
Enable Sending Shopware Order Mails for Renewal Orders : Envoie une confirmation de commande Shopware pour les renouvellements (facultatif).
Enable Addons for Subscriptions : Active la prise en charge des add-ons de Frisbii.
Enable Require Login to Buy Subscription Products : Exige que les utilisateurs soient connectés avant de s'abonner.
Default Order Status for Renewal Orders : Définit le statut initial des ordres de renouvellement.

ℹ️ Note : Ces paramètres permettent de personnaliser entièrement la façon dont les abonnements s'intègrent dans votre boutique Shopware. Ajustez-le en fonction de votre modèle d'entreprise.

3. Activer les modes de paiement Frisbii

Naviguez vers Settings → Payment methods. Vous trouverez ici toutes les modes supportés par Frisbii.

Activez uniquement les modes de paiement que vous avez également activés sur votre compte Frisbii : Tableau de bord de configuration des paiements Frisbii

Vous pouvez cliquer sur Edit pour personnaliser le nom, la description et le logo du mode de paiement.

✅ Conseil : Des étiquettes de paiement claires et reconnaissables à checkout peuvent augmenter les taux de conversion.

4. Rendre les modes de paiement visibles à checkout

Allez dans Storefront → Payment and Shipping et faites défiler jusqu'à la section Payment Methods.

Utilisez la liste déroulante pour sélectionner les modes qui doivent apparaître lors du checkout. Seules les modes activés à la fois dans Shopware et dans Frisbii fonctionneront.

5. Testez votre installation

Avant la mise en ligne, modifiez votre plugin afin d'utiliser la clé API de test Frisbii.

Étapes :

Allez dans la configuration du plugin.
Insérez votre clé API de test.
Ajoutez un produit au panier et passez à checkout.

⚠️ Rappel : Une fois les tests terminés et réussis, n'oubliez pas de remplacer votre clé API par votre clé API de live Frisbii. Cela garantit que vos clients peuvent effectuer des transactions réelles et s'abonner sans problème.

Une fois que vous avez vérifié que les transactions sont terminées et que les abonnements sont créés, vous pouvez passer à votre clé API live.

6. Créer un produit d'abonnement

Pour convertir un produit en abonnement :

Allez dans Catalogues → Products.
Créer un produit ou ouvrir un produit existant.
Naviguez jusqu'à l'onglet Frisbii Billing.

Options du plan :

Default Plan: Il s'agit de la formule d'abonnement de secours qui s'appliquera si aucune condition basée sur des règles ne correspond. Il est généralement utilisé dans les cas généraux où il n'est pas nécessaire d'établir une distinction en fonction des attributs du client.

Rule-Based Plans : Ils vous permettent d'attribuer dynamiquement des plans d'abonnement en fonction de conditions définies dans le Rule Builder de Shopware. Vous pouvez utiliser toutes les règles existantes de Shopware, telles que des devises spécifiques, des groupes de clients, des pays de facturation, ou même des règles personnalisées. Lorsqu'une règle correspond, le plan Frisbii correspondant est appliqué au lieu du plan par défaut.

ℹ️ Note : Rule-Based Plans offrent une grande flexibilité aux commerçants qui opèrent dans plusieurs régions ou devises, ou qui proposent des prix spécifiques à leurs clients. Veillez à ce que vos règles soient bien testées et qu'elles ne se chevauchent pas involontairement.

Vos plans Frisbii seront chargés automatiquement. Choisissez celui qui convient et confirmez. Vous pouvez maintenant modifier ou supprimer le plan pour faire du produit un produit Shopware normal.

✅ Conseil : Tenez à jour les prix de votre plan Frisbii. Si vous changez les prix dans Frisbii, réenregistrez le produit dans Shopware pour le synchroniser.

6a. Utilisation de variantes de produits

Si votre produit comporte plusieurs variantes (telles que la taille, la couleur ou le type), vous pouvez attribuer à chaque variante son propre plan d'abonnement Frisbii. Ceci est particulièrement utile lorsque chaque variante représente un niveau d'abonnement ou un prix différent.

Allez dans Catalogues → Products et sélectionnez votre produit variable.
Dans l'onglet Variants, ouvrez chaque variante spécifique.
Accédez à l'onglet Frisbii Billing pour cette variante.
Choisissez le plan Frisbii approprié pour cette variante.

ℹ️ Note : Chaque variante doit être sauvegardée individuellement après l'attribution d'un plan.

Une fois terminé, les clients sélectionnant une variante sur la vitrine seront abonnés au plan correspondant.

✅ Conseil : Utilisez des noms de plans et des prix clairs pour aider les clients à comprendre ce que chaque variante comprend.

7. Add-ons pour les produits d'abonnement

Vous pouvez compléter les abonnements par des services optionnels (add-ons) :

Créez l'add-on dans Frisbii.
Dans la section Disponibilité, sélectionnez les plans appropriés.

Enregistrez à nouveau le produit dans Shopware pour récupérer les nouveaux add-ons.

On/Off Add-ons: Une simple case à cocher permet d'inclure ou d'exclure l'add-on.
Quantity Add-ons: Les clients peuvent choisir le nombre d'unités à inclure.

ℹ️ Note : Vous pouvez utiliser des add-ons pour une assistance premium, des fonctionnalités supplémentaires ou des services groupés.

8. Remises et coupons

Les coupons et remises Frisbii sont compatibles avec le champ de bon de réduction natif de Shopware.

Créer un coupon dans Frisbii.
Partagez le code avec vos clients.
Les clients appliquent le code dans le champ de remise de Shopware.

→ La remise s'appliquera automatiquement à l'abonnement au moment du checkout.

✅ Conseil : Utilisez des remises à durée limitée ou des offres de lancement pour stimuler les conversions sur les nouveaux produits d'abonnement.