Stripe Connect encaisse les paiements par carte d'un restaurant via le compte Stripe de la plateforme, le restaurant étant un compte connecté. La plateforme peut ainsi conserver des frais sur chaque paiement — les frais d'application — et répartir les remboursements entre elle et le restaurant.

Mise en place#

  1. Le restaurant connecte son compte Stripe à la plateforme. Son identifiant de compte (acct_…) apparaît dans le tableau de bord Stripe de la plateforme, sous Comptes connectés.
  2. Dans la Vue de l'entreprise, ouvrez Finances → Intégration des paiements, cliquez sur + sur la vignette Stripe et choisissez Stripe Connect en haut du formulaire.
  3. Remplissez les champs ci-dessous — les clés sont celles de la plateforme — et cliquez sur Enregistrer.
  4. Dans la Vue de l'emplacement, ouvrez Finances → Modes de paiement et choisissez cette intégration sur le mode de paiement Carte.

Les premiers champs sont les mêmes que pour Stripe : Nom de l'identificateur, Clé publique, Clé secrète, Secret de signature du webhook, Règlement automatique des paiements, Apple Pay, Google Pay et ID Marchand iOS. Stripe Connect ajoute :

ChampDescription
Type de CompteStandard (le restaurant dispose de son propre compte Stripe complet) ou Express (un compte allégé géré par la plateforme).
Compte ConnectL'identifiant du compte connecté du restaurant, acct_….
Type de FraisFrais Directs ou Frais de Destination — voir ci-dessous.
Commission de CarteUn pourcentage de la valeur des articles de la commande, ajouté aux frais d'application pour répercuter les coûts de carte.
Frais de carte fixesUn montant fixe ajouté aux frais d'application sur chaque paiement.
Soustraire les frais de livraison, Soustraire le pourboire livreur, Soustraire le pourboire, Soustraire les frais de serviceUne fois activé, la totalité de ce montant revient à la plateforme : il s'ajoute aux frais d'application au lieu de rester au restaurant. À utiliser quand la plateforme assure la livraison ou facture les frais de service.
Montant fixe des frais d'applicationUn montant fixe ajouté aux frais d'application sur chaque paiement.
Commission en pourcentageLa commission de la plateforme, en pourcentage.
Règle de commissionCe sur quoi la commission est calculée : Total (tout ce que paie le client), ou n'importe lesquels parmi Sous-total (les articles), Frais de service, Frais de livraison, Pourboire, Taxes et Pourboire livreur.

Frais directs et frais de destination#

Frais DirectsFrais de Destination
Où le paiement est effectuéSur le compte connecté du restaurantSur le compte de la plateforme, puis reversé au restaurant
Nom sur le relevé de carte du clientCelui du restaurantCelui du restaurant
Qui paie les frais de traitement de carte de StripeLe restaurantLa plateforme
Comment la plateforme est rémunéréeLes frais d'application sont transférés du restaurant à la plateformeLa plateforme conserve les frais d'application et reverse le reste
Qui voit le paiement dans StripeLe restaurant en totalité ; la plateforme voit ses fraisLa plateforme en totalité ; le restaurant voit le montant reversé
Usage habituelComptes Standard : restaurants disposant de leur propre activité StripeComptes Express : la plateforme gère les paiements pour le restaurant

Les frais d'application#

Les frais d'application sont calculés pour chaque commande au moment du paiement et correspondent à la somme de :

  • Commission en pourcentage × ce que couvre la Règle de commission ;
  • Commission de Carte × la valeur des articles de la commande ;
  • Frais de carte fixes et Montant fixe des frais d'application ;
  • chaque montant dont l'interrupteur Soustraire … est activé (frais de livraison, pourboire livreur, pourboire, frais de service).

Le Sous-total correspond aux articles après remises lorsque le forfait d'utilisation de l'établissement prélève la commission après remises (le réglage habituel), sinon avant remises.

Exemple. Une commande d'une lasagne (32,00 $, remisée à 22,40 $) et de trois tiramisus (42,00 $), avec 5,72 $ de taxe de vente et 11,10 $ de pourboire, coûte 81,22 $ au client. Avec une Commission en pourcentage de 8 sur le Sous-total et rien d'autre de réglé, les frais d'application s'élèvent à 8 % × 64,40 $ = 5,15 $. La taxe et le pourboire ne supportent aucune commission.

Quand une commande par carte est-elle marquée payée#

Comme avec Stripe, la commande reste en Carte en attente jusqu'à ce que Stripe confirme le paiement via le webhook d'OrderTiger. Pour Stripe Connect, le webhook est créé sur le compte Stripe de la plateforme avec Événements de : Comptes connectés, afin de recevoir les paiements effectués sur les comptes des restaurants. Son secret de signature est enregistré dans Secret de signature du webhook à sa création.

Remboursements#

Les remboursements se font depuis Commandes, avec le bouton de remboursement de la commande. Pour une commande payée via Stripe Connect, le formulaire de remboursement demande Le commerçant est-il responsable de ce remboursement ? — case cochée par défaut. La réponse détermine qui paie le remboursement.

À la charge du commerçant (cochée)À la charge de la plateforme (décochée)
ClientRécupère le montant rembourséRécupère le montant remboursé
RestaurantPaie le remboursement, frais de traitement de carte de Stripe comprisConserve le montant initial moins les frais d'application initiaux, comme si la commande n'avait pas été remboursée. Avec les frais directs, il paie toujours les frais de traitement de carte de Stripe, comme pour toute vente
PlateformeRend sa part des frais d'applicationPaie la totalité du remboursement et conserve ses frais d'application
FacturesLe remboursement y figure et est déduit des gains du restaurantLe remboursement n'y figure pas : la plateforme l'a déjà payé

Pour un remboursement à la charge du commerçant, la part des frais d'application de la plateforme est égale aux frais d'application × le remboursement ÷ le total de la commande ; un remboursement intégral rend la totalité des frais d'application. Un remboursement à la charge de la plateforme laisse les frais d'application inchangés.

Exemple — la commande de 81,22 $ ci-dessus, avec ses 5,15 $ de frais d'application. Les frais de traitement de carte de Stripe sont laissés de côté pour simplifier.

Rembourser la lasagne (22,40 $)Rembourser toute la commande (81,22 $)
À la charge du commerçant : part des frais d'application rendue5,15 $ × 22,40 ÷ 81,22 = 1,42 $5,15 $
À la charge du commerçant : il reste au restaurant76,07 $ − 22,40 $ + 1,42 $ = 55,09 $0,00 $
À la charge du commerçant : il reste à la plateforme5,15 $ − 1,42 $ = 3,73 $0,00 $
À la charge de la plateforme : il reste au restaurant81,22 $ − 5,15 $ = 76,07 $81,22 $ − 5,15 $ = 76,07 $
À la charge de la plateforme : il reste à la plateforme5,15 $ − 22,40 $ = −17,25 $5,15 $ − 81,22 $ = −76,07 $

Sans aucun remboursement, il serait resté 81,22 $ − 5,15 $ = 76,07 $ au restaurant et 5,15 $ à la plateforme.

Dépannage#

ProblèmeÀ vérifier
Une commande payée reste en Carte en attenteDans le tableau de bord Stripe de la plateforme, vérifiez que Développeurs → Webhooks contient le webhook d'OrderTiger avec Événements de : Comptes connectés, et consultez ses derniers envois.
Les frais d'application ne sont pas ceux attendusVérifiez les cases de la Règle de commission : Total applique la commission à tout ce que paie le client, taxe et pourboire compris.
Les paiements échouent avec une erreur de compteLe Compte Connect doit être un compte connecté du compte de plateforme auquel appartiennent les clés, dans le même mode (test ou production).