Suivi des paiements

Le module Stancer ajoute un menu Stancer dans la section Banque du menu latéral gauche. Ce menu donne accès à quatre listes de suivi et à un tableau de bord.

Tableau de bord

La page d'accueil du module affiche un tableau de bord avec les indicateurs clés :

Chiffre d'affaires du mois en cours
Nombre de paiements capturés
Remboursements en cours
Contestations ouvertes
Répartition par méthode de paiement (CB / SEPA)
Comparaison annuelle des encaissements
Alertes (contestations et remboursements récents)
Derniers paiements reçus

Tableau de bord Stancer avec les KPI du mois, la répartition par méthode de paiement et les alertes

Note : en mode test, un bandeau d'avertissement rappelle que les données affichées sont des données de test.

Liste des paiements

Accessible via Banque > Stancer > Paiements.

Cette liste affiche tous les paiements enregistrés localement, synchronisés depuis l'API Stancer. Seuls les paiements correspondant au mode actuel (test ou production) sont affichés.

Liste des paiements Stancer avec les colonnes montant, statut, méthode et facture liée

Colonnes affichées

Colonne	Description
Réf.	Identifiant Stancer du paiement (`paym_xxx`)
Date	Date du paiement
Montant	Montant du paiement en euros
Frais	Commission Stancer sur ce paiement
Statut	Statut du paiement (voir ci-dessous)
Code réponse	Code de réponse bancaire (pour les rejets)
Facture / Commande	Lien vers la facture ou commande Dolibarr associée
Tiers	Nom du client

Statuts des paiements

Statut	Signification
Capturé	Paiement encaissé avec succès
Autorisé	Paiement autorisé, en attente de capture
Capture envoyée	Demande de capture envoyée à la banque
À capturer	Paiement en attente de capture manuelle
Contesté	Paiement contesté par le client
Expiré	Autorisation expirée sans capture
Échoué	Paiement échoué (erreur technique)
Refusé	Paiement refusé par la banque

Bouton Rafraîchir

Le bouton Rafraîchir en haut de la liste déclenche une synchronisation avec l'API Stancer :

Récupération des nouveaux paiements depuis l'API.
Vérification du statut des paiements locaux en attente.
Suppression des brouillons de paiement obsolètes.

Important : la synchronisation est déclenchée uniquement par ce bouton ou par les tâches planifiées. La navigation et le filtrage de la liste ne provoquent aucun appel API.

Liste des reversements

Accessible via Banque > Stancer > Reversements.

Un reversement (payout) correspond au virement effectué par Stancer vers votre compte bancaire. Il regroupe les paiements encaissés sur une période donnée, moins les commissions.

Liste des reversements Stancer avec les colonnes montant, date et statut

Colonnes affichées

Colonne	Description
Réf.	Identifiant Stancer du reversement
Date	Date du virement
Montant	Montant viré sur votre compte bancaire
Statut	Statut du reversement

Le bouton Rafraîchir synchronise les reversements depuis l'API et crée les écritures de transfert bancaire correspondantes dans Dolibarr (du compte Stancer vers votre compte principal).

Note : les reversements ne sont pas disponibles en mode test.

Liste des remboursements

Accessible via Banque > Stancer > Remboursements.

Cette liste affiche les remboursements effectués depuis Stancer vers vos clients.

Liste des remboursements Stancer avec les colonnes montant, date, statut et paiement d'origine

Lorsqu'un remboursement est confirmé, le module :

Rouvre la facture associée (passage en statut "Impayée").
Envoie une notification à l'administrateur.

Créer un remboursement

Depuis la fiche d'un paiement capturé, vous pouvez initier un remboursement :

Ouvrez le paiement dans la liste.
Cliquez sur Rembourser.
Saisissez le montant à rembourser (total ou partiel).
Confirmez.

Le remboursement est envoyé à l'API Stancer et apparaîtra dans la liste après synchronisation.

Liste des contestations

Accessible via Banque > Stancer > Contestations.

Une contestation (dispute) survient lorsqu'un client conteste un paiement auprès de sa banque.

Liste des contestations Stancer avec les colonnes montant, date, statut et paiement contesté

Lorsqu'une contestation est perdue (statuts : perdue, acceptée, hors délai, non contestable), le module :

Rouvre la facture associée (passage en statut "Impayée").
Envoie un email de notification à l'administrateur et au client.
Crée une facture de frais de rejet si l'option est configurée (voir Prélèvements SEPA).

Le bouton Rafraîchir synchronise les contestations depuis l'API Stancer.

Résultat de chaque paiement dans les événements de la facture

Chaque tentative de paiement Stancer d'une facture laisse un événement dans l'onglet Événements de la facture, avec les mêmes conventions que les prélèvements Stripe du cœur de Dolibarr :

Code de l'événement	Signification
`AC_PAYMENT_STANCER_OK`	Le paiement a été encaissé par Stancer et enregistré sur la facture
`AC_PAYMENT_STANCER_KO`	Stancer a refusé le paiement, l'a laissé échouer ou expirer, ou le client l'a contesté

Ces événements sont de type "Événement automatique" (AC_OTH_AUTO), rattachés au tiers et à la facture. Il y en a un seul par paiement Stancer et par facture : les synchronisations quotidiennes, le retour du client sur la page de paiement et la synchronisation des contestations ne le créent pas une seconde fois. L'identifiant du paiement Stancer (paym_...) est conservé dans la référence externe de l'événement.

Pour un échec, la date de l'événement est celle de l'échec chez Stancer quand elle est connue (refus d'une carte, date de la contestation), sinon celle de sa détection. Le champ des paramètres complémentaires contient le statut Stancer, le code de réponse et son explication, séparés par " - ", par exemple disputed - AM04 - Provision insuffisante.

Un paiement encaissé puis contesté porte les deux événements. Le paiement d'une commande ou d'un devis n'en crée pas tant qu'il n'existe pas de facture : l'événement de réussite est posé sur la facture créée à partir de la commande ou du devis, un échec avant facturation n'en laisse aucun.

Les autres modules peuvent s'appuyer sur ces codes comme sur ceux de Stripe, par exemple pour espacer les nouvelles tentatives de prélèvement ou pour suspendre un service après plusieurs échecs. Une règle qui cherche AC_PAYMENT_%_KO dans llx_actioncomm (filtrée sur elementtype = 'invoice' et fk_element) couvre ainsi Stripe et Stancer.

Les événements historiques du module restent créés comme avant : réouverture de facture (AC_BILL_REOPEN_FAILED_...), notification à l'administrateur (AC_ADMIN_PAYERROR_...), emails envoyés et AC_STANCER_PAYMENT_OK, qui indique que le paiement et sa ligne bancaire ont été enregistrés.

Onglet Stancer sur la fiche tiers

Chaque fiche tiers dispose d'un onglet Stancer qui centralise les informations de paiement du client :

Compte client Stancer : identifiant du client chez Stancer
Cartes bancaires enregistrées (type, derniers chiffres, expiration)
Mandats SEPA en cours (IBAN partiellement masqué)
Liens publics : URL de la page de saisie d'IBAN et de la page d'enregistrement CB

Depuis cet onglet, vous pouvez :

Créer ou lier un compte client Stancer
Enregistrer une carte bancaire
Enregistrer un mandat SEPA
Supprimer un mandat SEPA
Synchroniser les mandats SEPA avec Stancer : le bouton Synchroniser les mandats SEPA avec Stancer complète un BIC manquant et vérifie chez Stancer chaque mandat du tiers. L'affichage de l'onglet ne modifie plus rien, cette vérification se fait uniquement par ce bouton, réservé aux utilisateurs ayant le droit d'écriture du module
Copier les liens publics pour les envoyer au client

Onglet Stancer complet sur la fiche tiers avec les sections compte client, CB et SEPA

Boutons de paiement sur les fiches

Le module ajoute des boutons d'action sur les fiches de plusieurs objets Dolibarr :

Facture : bouton pour lancer un paiement CB ou SEPA
Commande : bouton pour envoyer un lien de paiement
Devis : bouton pour envoyer un lien de paiement (si configuré)

Ces boutons sont visibles par les utilisateurs disposant de la permission "Créer/modifier les données Stancer".

Bouton de paiement Stancer sur la fiche d'une facture validée