Connectez votre boutique. Présentez vos produits.

Les produits et les alertes sont indépendants

Utilisez Monétisation dans SSN pour promouvoir des produits et pages de soutien publics, recevoir l’activité, ou les deux. Ce guide couvre Fourthwall, Ko-fi et Buy Me a Coffee. Pour NinjaBacker, Throne, Amazon et eBay, consultez le guide de monétisation.

Connecter les alertes · Fourthwall · Ko-fi · Buy Me a Coffee · Importer un produit · OBS et codes QR · Dépannage

Connecter les alertes d’activité

1. Ouvrir Monétisation → Alertes Fourthwall, Ko-fi et Buy Me a Coffee et choisissez votre fournisseur.
2. Cliquez sur Paramètre du récepteur. Activez l’option existante contrôle distant de l’extension par API (remote API control of extension) , puis gardez SSN actif.
3. Revenez à Monétisation et cliquez sur Copier l’URL du webhook. Collez cette adresse privée dans les paramètres de webhook de votre fournisseur ci-dessous.
4. Vérifiez l’état du récepteur. Récepteur connecté signifie que SSN écoute, pas que la configuration du fournisseur a été vérifiée. La ligne du dernier événement se met à jour lorsqu’un événement interprété et non dupliqué atteint cette application ; elle se réinitialise au redémarrage.
5. Utilisez Aperçu d’alerte d’exemple pour vérifier l’apparence sur une page d’exemple séparée. Cela n’envoie aucun paiement, ne modifie aucun total, n’exécute pas Event Flow et ne vérifie pas le webhook.

Ces trois points de réception existants à URL de session reposent sur la confidentialité de l’URL ; SSN n’accepte actuellement pas leurs secrets de signature. Ils conviennent aux alertes de direct, pas comme preuve de paiement pour exécuter une commande. Ne publiez pas l’adresse du webhook et ne l’utilisez pas comme destination QR pour le public.

Fourthwall

1. Dans Fourthwall, ouvrez Paramètres → Pour les développeurs → Webhooks.
2. Créez un webhook et collez l’URL Fourthwall copiée depuis SSN.
3. Sélectionnez les événements compatibles dont vous avez besoin : ORDER_PLACED, GIFT_PURCHASE, DONATION et SUBSCRIPTION_PURCHASED.
4. Enregistrez le webhook et gardez SSN actif.

Les commandes apparaissent comme achats, les produits offerts comme cadeaux et les nouveaux abonnements comme adhésions. Par compatibilité, les commandes Fourthwall ordinaires conservent leur valeur de don existante. Les commandes utilisant une carte cadeau ne recomptent pas la valeur prépayée. Les événements marqués comme tests sont ignorés.

documentation des webhooks Fourthwall · Aperçu d’un achat d’exemple

Ko-fi

1. Ouvrir Webhooks Ko-fi.
2. Collez l’URL Ko-fi copiée depuis SSN dans URL du webhook, puis enregistrez ou mettez à jour.
3. Gardez SSN actif. Les pourboires publics, paiements d’adhésion, commandes et commissions utilisent la même connexion.

Les paiements privés sont exclus. Les paiements d’adhésion apparaissent comme activité de membre ; les commandes et commissions comme achats sans augmenter les dons. Ko-fi n’envoie pas d’annulations d’adhésion via ce webhook.

Tests : utilisez d’abord l’aperçu isolé de SSN. Les exemples de paiement Ko-fi peuvent ressembler à des paiements réels et déclencher alertes, totaux et actions s’ils sont envoyés au récepteur actif. N’utilisez pas le test du fournisseur sur une session avec récompenses payantes activées.

documentation des webhooks Ko-fi · Aperçu de soutien d’exemple

Buy Me a Coffee

1. Ouvrir Intégrations dans le tableau de bord du créateur et choisissez Nouveau webhook.
2. Donnez-lui un nom et collez l’URL Buy Me a Coffee de SSN comme point d’accès.
3. Sélectionnez donation.created, extra_purchase.created, commission_order.created, wishlist_payment.created et membership.started selon les besoins.
4. Enregistrez et laissez la livraison activée. Utilisez l’historique de livraison du fournisseur pour diagnostiquer les échecs.

Les commandes de boutique et commissions sont des achats. Les paiements de liste de souhaits sont des contributions à des cadeaux. Les débuts d’adhésion sont des annonces, pas des débits confirmés distincts. Les notes masquées restent cachées et les soutiens anonymes restent anonymes. Les tests du tableau de bord marqués live_mode: false sont ignorés sans alerte payante. Les remboursements et mises à jour du cycle de vie ne créent pas de paiements et n’annulent pas les totaux existants.

documentation des webhooks Buy Me a Coffee · Aperçu d’une contribution d’exemple

Importer un produit Fourthwall

1. Dans la section Fourthwall Paramètres → Pour les développeurs (Settings → For Developers), créez un Token Storefront. Utilisez le token Storefront pour accéder au catalogue public, pas une clé API administrative.
2. Dans SSN, ouvrez Produits et liens de soutien → Configurer les produits et liens → Importer un produit Fourthwall.
3. Collez l’URL publique du produit et le token, puis cliquez sur Charger les détails du produit.
4. Vérifiez le nom, l’image, le prix et l’URL chargés. Confirmez que l’URL appartient à la même boutique que le token, y compris un éventuel domaine personnalisé. Le token détermine le catalogue interrogé.
5. Choisissez Acheter, Offrir, Soutenir ou Rejoindre selon l’action du public. Cliquez sur Ajouter un produit ou un lien, activez Produits et liens de soutien, puis Enregistrer la configuration.

Cette fonction importe un produit public disponible à la fois via l’API Storefront de Fourthwall. Le token sert à cette requête, puis est effacé ; il n’est ni enregistré ni envoyé aux incrustations. Les prix variables et les lots restent vides pour ne pas suggérer un total fixe. L’importation est un instantané : prix, stocks et images ne se mettent pas à jour automatiquement. Réimportez ou modifiez lorsqu’ils changent. Le catalogue contient jusqu’à 20 entrées ; ajouter à nouveau crée une autre entrée.

Créer un token Storefront · Champs de produit Fourthwall

Afficher les produits, liens publics et codes QR

Vous pouvez aussi saisir un lien public de produit ou de soutien de n’importe quel site, dont Shopify, Tiltify ou Patreon. Ajoutez une URL d’image et un prix facultatif, choisissez l’objectif, activez le catalogue et enregistrez. Ajouter un lien ne connecte pas un flux de paiements.

1. Choisir Produits et liens de soutien sous Lien d’incrustation pour.
2. Ouvrir Options du lien d’incrustation. Choisissez Vitrine de produits, Carte de soutien, Alertes d’activité ou la vue combinée.
3. Cliquez sur Copier le lien OBS et collez-le dans une source navigateur OBS. Commencez à 800 × 600. Pour séparer promotion et activité, créez une source par vue.
4. Utilisez Options d’affichage pour fixer le premier produit ou faire tourner les entrées. Activez les codes QR pour que le public accède à la destination publique. Utilisez Copier le lien public à côté d’une entrée pour partager vous-même son adresse cliquable dans le chat.

La vitrine inclut l’image du produit si elle est fournie ; la petite carte de soutien la masque. Les alertes d’activité fonctionnent séparément et n’ajoutent pas le QR d’un produit sans rapport dans la rotation. Gardez le lien public lisible et testez le QR avec un téléphone dans la disposition finale d’OBS. Modifier l’échelle du lien OBS ou trop recadrer peut gêner le scan.

Pour multi-alerts ou le fil d’activité, utilisez leurs liens d’incrustation existants avec la même session SSN. Le catalogue de produits n’a pas besoin d’être activé pour ces incrustations existantes. La vue d’activité générique de Monétisation exige le catalogue actif. Dans Event Flow, Don reste le déclencheur des lignes contenant hasDonation; utilisez Type d’événement pour les achats ou cadeaux terminés. Consultez la correspondance des événements.

Si rien n’apparaît

• Récepteur désactivé : activez le contrôle distant de l’extension par API. Les autres interrupteurs API servent à d’autres usages.
• Déconnecté : gardez SSN actif et vérifiez le réseau. Cet état est celui du récepteur partagé, pas l’état de livraison du tableau de bord du fournisseur.
• Aucun événement reçu : vérifiez le fournisseur choisi, l’URL privée et les paramètres de livraison. Un aperçu local réussi ne vérifie que l’apparence.
• Événement ignoré : les tests marqués, paiements privés, types non pris en charge et montants invalides sont exclus. Aucun détail de l’acheteur n’apparaît dans l’état.
• Événement reçu, mais aucune incrustation : vérifiez la session/le mot de passe, les filtres de sources, catégories d’événements, règles SSN et visibilité OBS. Les achats ne sont pas des abonnements ; la plupart ne sont pas des dons.
• Doublons : évitez d’envoyer le même paiement via le fournisseur direct et un agrégateur. La déduplication des tentatives utilise les ID de livraison du fournisseur.
• Échec de l’importation : vérifiez le slug du produit, le token Storefront et que le produit est public et disponible. La saisie manuelle reste possible.

Il s’agit de l’activité du direct, pas d’un registre de commandes. Utilisez le tableau de bord du fournisseur pour confirmer les paiements, rembourser et traiter les commandes. Shopify dispose désormais de sa propre importation de produits et configuration de commandes payées signées. L’activité des campagnes Tiltify et les adhésions payantes Patreon restent des intégrations à venir.