Configurer la Boutique plateforme

La page Boutique : paiement et transport de la Console (domaine Offres et prix) est réservée à l'éditeur de SheepOS. Elle branche le paiement (Stripe Connect) et le transport (Boxtal) de toutes les boutiques. Les clés saisies sont chiffrées à l'enregistrement et ne sont jamais réaffichées. Chaque encadré repliable de la page reprend les étapes ci-dessous, avec les adresses à copier. Voir aussi la boutique en ligne.

Tâches courantes

Préparer le serveur

1. Générez la clé de chiffrement sur le serveur avec la commande openssl rand -base64 32.
2. Placez le résultat dans la variable d'environnement INTEGRATIONS_TOKEN_KEY de l'API, jamais dans un fichier versionné ni dans un message. Sans elle, la page affiche un avertissement et aucune clé ne peut être enregistrée.
3. Pour renouveler la clé sans rien perdre, gardez l'ancienne dans INTEGRATIONS_TOKEN_KEY_PREVIOUS pendant la rotation.

Brancher Stripe Connect

1. Dans le tableau de bord Stripe, activez Connect avec des comptes Standard : chaque marchand ouvre son propre compte et SheepOS ne conserve aucune pièce d'identité.
2. Dans Développeurs, puis Clés API, copiez la clé secrète de test (sk_test_…) et, pour la production, la clé secrète sk_live_… (ou une clé restreinte rk_live_…). Collez-les dans le champ « Clé secrète » du mode correspondant.
3. Dans Développeurs, puis Webhooks, ajoutez un point de terminaison de type Connect. L'adresse est affichée sur la page, avec un bouton Copier : elle se termine par /public/shop-payments/webhooks/stripe.
4. Cochez les événements : checkout.session.completed, payment_intent.succeeded, payment_intent.payment_failed, charge.refunded, charge.dispute.created, charge.dispute.closed, account.updated, account.application.deauthorized, payout.created, payout.updated, payout.paid, payout.failed et payout.canceled.
5. Copiez le secret de signature du point de terminaison (whsec_…) dans « Secret de signature du webhook ». Créez un point de terminaison par mode : chacun a son secret.
6. Enregistrez, puis lancez Tester la connexion dans chaque mode.

Brancher Boxtal

1. Dans votre compte Boxtal, ouvrez l'espace développeur et créez une clé d'API : vous obtenez une clé d'accès et une clé secrète.
2. Collez-les dans les champs du mode correspondant (clés du bac à sable en test, clés de production en réel).
3. Déclarez dans les webhooks de Boxtal l'adresse affichée sur la page (elle se termine par /public/shop-carriers/webhooks/boxtal) et copiez le secret de signature dans le champ prévu.
4. Enregistrez et testez la connexion dans chaque mode.

Régler la commission et la marge de transport

La commission est prélevée sur chaque vente (un pourcentage avec un plafond par commande) et peut varier selon l'offre du marchand. La marge de transport s'ajoute au prix d'achat de l'étiquette (un pourcentage avec un minimum par colis). Les sommes dues à SheepOS sont regroupées chaque mois en brouillon de facture, à relire avant émission.

Ouvrir le mode réel

1. Vérifiez que les clés de production sont enregistrées et que le test de connexion de production réussit.
2. Appuyez sur Ouvrir le mode réel puis confirmez.
3. Les marchands qui avaient connecté un compte en mode test ne peuvent plus encaisser tant qu'ils n'ont pas refait leur inscription Stripe en production, depuis l'onglet Paiement de leur boutique. Fermer le mode réel les remet en essai.

Suivre toutes les boutiques

Le domaine Offres et prix de la Console propose aussi la vue Boutiques : toutes les boutiques de toutes les organisations clientes, en agrégats seulement, sans aucune donnée sur les acheteurs.

1. Ouvrez Offres et prix → Boutiques. En haut, des compteurs donnent le nombre de boutiques, dont celles en ligne, en brouillon et suspendues.
2. Cherchez par boutique, organisation ou adresse, filtrez par statut (Brouillon, En ligne, Suspendue) et par mode de paiement (Essai ou Réel), puis triez (organisation, nom, statut, produits, commandes ou chiffre d'affaires sur 30 jours, date de création).
3. Le tableau donne, pour chaque boutique, l'organisation, le statut, le mode de paiement, l'état de la connexion Stripe, le nombre de produits, les commandes et le chiffre d'affaires sur 30 jours, la création et l'adresse de la vitrine publique (bouton Copier). Exporter en CSV télécharge la liste.
4. Ouvrez une boutique pour son Tableau de bord de la boutique : période (7 jours, 30 jours, 12 mois ou Personnalisée), chiffre d'affaires encaissé, commandes payées, panier moyen, taux de conversion, répartition par canal (particuliers ou professionnels), par mode de livraison et par moyen de paiement, produits, retours, litiges et commissions perçues, puis l'état de configuration (Fait, À faire, Conseillé).

Liste de vérification finale

• INTEGRATIONS_TOKEN_KEY est définie sur le serveur.
• Connect est activé en comptes Standard, la clé de production et le secret du webhook Connect sont enregistrés, le test de production réussit.
• Le webhook Connect de production pointe vers l'adresse affichée et reçoit les événements listés.
• Boxtal : clés de production, secret de suivi et webhook de suivi en place.
• Commission et marge réglées pour chaque offre.
• Le régime de TVA, le taux par défaut, le SIRET, le numéro de TVA et l'adresse de l'organisation éditrice sont renseignés.
• Un marchand a fini son inscription Stripe en production et reçu un paiement de bout en bout.
• Le mode réel n'est ouvert qu'après tous ces points.

À savoir

La TVA des factures de commission et de transport dépend du régime de l'organisation éditrice, celle que désigne la variable PLATFORM_ORGANIZATION_ID : sans régime de TVA ni numéro, ses brouillons de factures ne peuvent pas être émis. SheepOS ne donne aucun conseil juridique ni fiscal : faites valider ces réglages par votre expert-comptable.