Encaisser par carte avec Stripe sur votre boutique

Stripe sert aux boutiques Yalla Souk dont la devise est l’euro, le dollar américain, la livre sterling, le dollar canadien ou le franc suisse, avec un compte Stripe ouvert par une entreprise immatriculée dans un pays pris en charge par Stripe (la Tunisie n’en fait pas partie). Créez une clé restreinte avec deux autorisations, collez-la dans Intégrations › Paiement › Stripe, puis activez le paiement par carte.

Fonctionnement vérifié dans le produit et documentation Stripe consultée le 22 octobre 2026.

Stripe dans Yalla Souk en un coup d’œil

Qui peut utiliser Stripe avec Yalla Souk ?

Deux conditions, l’une chez Stripe, l’autre chez Yalla Souk. Chez Stripe, le compte doit appartenir à une entreprise immatriculée dans un pays où Stripe est disponible : la liste publiée par Stripe ne comprend pas la Tunisie, donc une entreprise tunisienne ne peut pas ouvrir de compte Stripe. Chez Yalla Souk, la devise de la boutique doit être l’une de celles que l’intégration encaisse : euro, dollar américain, livre sterling, dollar canadien ou franc suisse.

Le cas typique : une marque qui a une société en France, au Canada ou au Royaume-Uni et vend avec Yalla Souk dans cette devise. Pour une boutique en dinars, le paiement en ligne passe par Flouci. Si la devise de votre boutique n’est pas prise en charge, la carte Stripe s’affiche désactivée avec le motif.

Comment créer la clé restreinte Stripe ?

1. Dans votre tableau de bord Stripe, en mode réel (live), ouvrez la page API keys.
2. Créez une clé restreinte (restricted key) pour Yalla Souk.
3. Accordez-lui exactement deux autorisations : Checkout Sessions : Write et Webhook Endpoints : Write.
4. Copiez la clé, qui commence par rk_live_. Stripe ne la réaffiche pas une fois quittée : copiez-la tout de suite.

Pourquoi une clé restreinte et pas la clé secrète ? Stripe recommande lui-même les clés restreintes, dont vous limitez les droits, plutôt que la clé secrète qui ouvre toute l’API. Yalla Souk refuse les clés sk_ pour la même raison.

Comment connecter Stripe à Yalla Souk ?

1. Ouvrez Intégrations, catégorie Paiement, et cliquez sur Connecter sur la carte Stripe.
2. Collez la clé restreinte et validez.
3. Yalla Souk vérifie la clé et crée lui-même, sur votre compte Stripe, le point de terminaison webhook qui lui annonce les paiements. Il apparaît dans Stripe sous le nom « Yalla Souk order payments ».
4. Une fois le statut « Connecté », activez Accepter les paiements par carte Stripe sur ma boutique.

Les messages d’erreur disent quoi corriger : clé secrète au lieu de restreinte, clé supprimée ou mal copiée, autorisation manquante, ou compte Stripe qui ne peut pas encaisser dans la devise de la boutique.

Comment se passe un paiement Stripe ?

1. Au checkout, le client choisit le paiement par carte et valide la commande.
2. Il est redirigé vers la page de paiement hébergée par Stripe (Stripe Checkout), dans la devise de votre boutique, où il saisit sa carte ou utilise un portefeuille proposé par votre compte Stripe.
3. La session de paiement reste ouverte au moins 30 minutes et au plus 24 heures, dans la limite de la durée de vie de la commande.
4. Stripe confirme le paiement à Yalla Souk par le webhook ; la commande est marquée payée automatiquement.
5. Les fonds arrivent sur votre compte Stripe, puis sur votre compte bancaire selon votre calendrier de versement Stripe.

Quelles limites et responsabilités ?

• Remboursements et litiges : gérés dans votre tableau de bord Stripe. Yalla Souk ne traite ni remboursements, ni litiges, ni rétrofacturations.
• Montant minimum : si un total est en dessous du minimum Stripe pour la devise, cette commande ne peut pas être payée par carte ; la connexion, elle, reste valide.
• Déconnexion : déconnecter Stripe supprime votre clé de Yalla Souk et retire le webhook créé sur votre compte Stripe.
• Espèces : le paiement à la livraison ou au retrait reste disponible tant que vous ne le désactivez pas.

Questions fréquentes sur Stripe et Yalla Souk