Questions fréquentes

Le module affiche « Le module Stripe n'est pas configuré »

Le module Rapprochement Stripe dépend du module Stripe natif de Dolibarr. Rendez-vous dans Accueil > Configuration > Modules > Stripe et renseignez vos clés API (clé secrète live ou test). Le module détecte automatiquement le mode actif (Live ou Sandbox).

Le module affiche « Le compte bancaire Stripe n'est pas configuré »

Rendez-vous dans la configuration du module et sélectionnez le compte bancaire Dolibarr qui représente votre compte Stripe. Ce compte doit exister dans Banque/Caisse > Comptes bancaires.

Des transactions ne sont pas liées à un paiement Dolibarr

Le module associe les transactions Stripe aux paiements Dolibarr via le champ ext_payment_id de la table llx_paiement. Ce champ est renseigné automatiquement par le module Stripe natif lors de l'enregistrement d'un paiement. Si une transaction n'est pas liée, les causes possibles sont :

• Le paiement a été enregistré manuellement dans Dolibarr sans passer par le module Stripe.
• Le paiement a été effectué sur une autre instance Dolibarr.
• L'identifiant Stripe a été modifié ou supprimé.

Le montant net ne correspond pas au montant du payout

Sur la fiche détaillée d'un payout, si la somme des montants nets des transactions ne correspond pas au montant du payout, un avertissement s'affiche. Les causes habituelles sont :

• Toutes les transactions du payout n'ont pas encore été synchronisées. Cliquez sur Synchroniser les transactions Stripe pour mettre à jour.
• Le payout inclut des transactions de type non géré (remboursements, ajustements, litiges).
• Des frais Stripe supplémentaires (frais de change, frais de litige) ne sont pas comptés dans les transactions de type « charge ».

Puis-je utiliser le module en mode Sandbox (test) ?

Oui. Le module utilise le mode configuré dans le module Stripe natif. Si Stripe est en mode Sandbox, un bandeau d'avertissement « Vous êtes actuellement en mode Sandbox » s'affiche sur chaque page du module. Les données synchronisées proviennent alors de l'environnement de test Stripe.

Les frais ne sont pas enregistrés comme écritures bancaires

Vérifiez que l'option Enregistrer les frais est activée dans la configuration. Si elle est désactivée, les commissions Stripe ne sont pas enregistrées individuellement. Vous devez alors les comptabiliser globalement via les factures mensuelles de Stripe.

L'onglet Comptabilité n'apparaît pas

L'onglet Comptabilité n'est visible que si le module Comptabilité avancée (double entry accounting) est activé dans Dolibarr. Si vous utilisez uniquement la comptabilité simple, cet onglet n'est pas disponible.

Aucun écart n'est détecté dans l'onglet Comptabilité

La détection des écarts nécessite que :

1. Le fournisseur Stripe soit configuré et possède un code comptable fournisseur.
2. Le journal des OD et le compte d'écart soient renseignés.
3. Les factures fournisseur Stripe soient saisies et transférées en comptabilité.
4. Des écarts d'arrondi existent et soient inférieurs au seuil configuré (0,05 EUR par défaut).

Si toutes ces conditions sont réunies mais qu'aucun écart n'apparaît, cela signifie que les écritures comptables sont équilibrées ou que les écarts ont déjà été régularisés.

Comment annuler un rapprochement ?

Le module ne propose pas de bouton d'annulation directe du rapprochement. Pour annuler un rapprochement :

1. Accédez à l'écriture bancaire concernée dans Dolibarr (Banque > Écritures).
2. Retirez manuellement le marquage de rapprochement (rappro).

Pour les relevés mensuels, utilisez le bouton Supprimer sur la page des relevés, qui retire le numéro de relevé et le marquage de rapprochement de toutes les écritures du mois.

La synchronisation échoue avec une erreur API Stripe

Vérifiez les points suivants :

• Vos clés API Stripe sont valides et non expirées.
• Votre serveur a accès à Internet et peut joindre api.stripe.com.
• La librairie PHP Stripe incluse dans Dolibarr est compatible avec votre version de PHP.

Le message d'erreur exact retourné par l'API Stripe est affiché pour faciliter le diagnostic.

Quelle est la différence entre le rapprochement sur un payout et le rapprochement global ?

• Rapprocher tout (sur un payout) : rapproche uniquement les transactions du payout sélectionné.
• Rapprochement automatique (page Rapprocher) : rapproche toutes les transactions en attente de l'ensemble des payouts, à condition qu'elles aient un paiement Dolibarr lié.

Les deux actions produisent le même résultat sur les transactions concernées : marquage de l'écriture bancaire comme rapprochée et, si activé, enregistrement de l'écriture de frais.