Stripe encaisse les paiements par carte des commandes en ligne directement sur un seul compte Stripe : celui auquel appartiennent les clés de l'intégration, en général celui du restaurant. Stripe verse ensuite les fonds de ce compte sur son compte bancaire. OrderTiger ne prélève aucuns frais dans Stripe ; les éventuels frais OrderTiger sont facturés à part, sur les factures du restaurant.
Pour prélever une part de chaque paiement dans Stripe, ou pour encaisser les paiements pour le compte de restaurants, utilisez plutôt Stripe Connect.
Mise en place#
- Dans la Vue de l'entreprise, ouvrez Finances → Intégration des paiements et cliquez sur + sur la vignette Stripe.
- Laissez Stripe sélectionné en haut du formulaire (et non Stripe Connect).
- Remplissez les champs ci-dessous et cliquez sur Enregistrer.
- Dans la Vue de l'emplacement, ouvrez Finances → Modes de paiement, ajoutez ou modifiez le mode de paiement Carte et choisissez cette intégration comme processeur de paiement.
| Champ | Description |
|---|---|
| Nom de l'identificateur | Le nom que vous donnez à l'intégration, affiché dans les listes et lorsque vous la choisissez sur un mode de paiement. |
| Clé publique | La clé publiable Stripe (pk_live_… ou pk_test_…), disponible dans Développeurs → Clés API sur Stripe. |
| Clé secrète | La clé secrète Stripe (sk_live_… ou sk_test_…) du même compte. Elle est masquée par défaut ; cliquez sur l'icône en forme d'œil pour l'afficher. |
| Secret de signature du webhook | Facultatif. Laissez-le vide : à l'enregistrement, OrderTiger crée son webhook sur ce compte Stripe et le renseigne pour vous. |
| Règlement automatique des paiements | Activé : la carte est débitée dès que le client paie. Désactivé : le montant est seulement réservé sur la carte, puis débité quand la commande est acceptée. Les établissements qui confirment automatiquement les commandes débitent toujours immédiatement. |
| Apple Pay / Google Pay | Proposez ces portefeuilles au paiement. Apple Pay nécessite aussi que le domaine soit vérifié dans Stripe. |
| ID Marchand iOS | L'identifiant marchand Apple Pay utilisé par l'application de commande iOS. Visible uniquement par les super-administrateurs. |
Quand une commande par carte est-elle marquée payée#
Une fois que le client a payé, la commande reste en Carte en attente jusqu'à ce que Stripe confirme le paiement. Stripe le confirme en appelant le webhook d'OrderTiger ; la commande est alors payée et apparaît dans Commandes en direct.
- Le webhook est créé pour vous sur le compte Stripe à l'enregistrement de l'intégration ; il écoute l'événement
charge.succeeded. Vous le trouverez dans Stripe sous Développeurs → Webhooks. - Son secret de signature est enregistré dans Secret de signature du webhook. Avec un secret enregistré, OrderTiger n'accepte une confirmation de paiement que si elle porte la signature de Stripe. Sans secret, la confirmation est acceptée sans cette vérification.
- Si le webhook existait déjà lors de l'enregistrement, il est réutilisé et le champ reste vide : Stripe ne communique le secret d'un webhook qu'au moment de sa création. Copiez-le depuis le webhook dans Stripe (Afficher) et collez-le dans le champ, ou supprimez le webhook dans Stripe et enregistrez de nouveau l'intégration.
Remboursements#
Les remboursements se font depuis Commandes, avec le bouton de remboursement de la commande. Le remboursement est prélevé sur le compte Stripe qui a encaissé le paiement et retourne sur la carte du client.
- Il n'y a pas de frais à répartir : la totalité du remboursement est prélevée sur ce compte.
- Stripe ne rembourse pas ses propres frais de traitement de carte lors d'un remboursement.
- Pour les commandes d'une société de type portail, le formulaire de remboursement demande Le commerçant est-il responsable de ce remboursement ?. Avec Stripe seul, l'argent sort toujours de ce compte Stripe ; la réponse décide seulement de la façon dont le remboursement apparaît sur les factures : un remboursement à la charge du commerçant est déduit des gains du restaurant, un remboursement à la charge de la plateforme ne l'est pas.
- Un remboursement peut être partiel ; les montants déjà remboursés sont listés sous la commande.
Dépannage#
| Problème | À vérifier |
|---|---|
| Une commande payée reste en Carte en attente et n'arrive jamais dans Commandes en direct | La confirmation de Stripe n'est pas arrivée. Dans Stripe, vérifiez que Développeurs → Webhooks contient le webhook d'OrderTiger et consultez ses derniers envois. S'il manque, enregistrez de nouveau l'intégration pour le créer. |
| Secret de signature du webhook reste vide après l'enregistrement | Le webhook existait déjà. Collez son secret depuis Stripe, ou supprimez le webhook dans Stripe et enregistrez de nouveau. |
| Les paiements échouent avec une erreur d'authentification | La Clé secrète et la Clé publique doivent provenir du même compte Stripe et du même mode (toutes deux de test ou toutes deux de production). |