---
title: "tpeConnect"
weight: 1
description: "Connectez votre terminal de paiement CB avec Dolibarr pour automatiser la saisie des montants et récupérer les tickets CB dématérialisés."
category: "Paiement & Facturation"
type: "module-dolibarr"
---

# tpeConnect pour Dolibarr

tpeConnect relie votre terminal de paiement électronique (TPE) à votre ERP Dolibarr. Le module supprime la double saisie du montant sur le terminal et permet de récupérer le ticket CB dématérialisé directement dans Dolibarr.

## Fonctionnalités principales

- **Envoi automatique du montant** : le montant de la facture est transmis directement au TPE, sans ressaisie manuelle et sans risque d'erreur.
- **Ticket CB dématérialisé** : le ticket commerçant et le ticket client sont récupérés au format PDF et rattachés à la facture.
- **Paiement depuis la fiche facture** : un bouton "CB/TPE" apparaît sur les factures dont le mode de paiement est Carte Bancaire.
- **Paiement depuis TakePOS** : un bouton TPE est ajouté dans la caisse enregistreuse Dolibarr (TakePOS).
- **Multi-TPE** : jusqu'à 3 terminaux de paiement configurables, chacun associable à une caisse TakePOS.
- **Paiement fractionné** : possibilité de régler une facture en plusieurs paiements CB successifs.
- **Agent logiciel relais** : un petit programme à installer sur le poste de caisse assure la communication entre votre serveur Dolibarr et le TPE sur le réseau local.

## Terminaux compatibles

Le module fonctionne avec les terminaux de paiement compatibles avec le protocole réseau Verifone/Ingenico, notamment :

- Verifone (par exemple les TPE livrés par Stancer)
- Ingenico DESK 5000

## Prérequis

- Dolibarr version 11.0 ou supérieure
- PHP 7.3 ou supérieur
- Le TPE doit être connecté au réseau local (Ethernet ou Wi-Fi)
- L'agent logiciel relais doit être installé et lancé sur le poste de caisse

## Architecture

Le module ne communique pas directement avec le TPE. Un **agent logiciel** fourni par CAP-REL doit être lancé sur le poste de caisse. Cet agent écoute sur le port local 8002 et relaye les demandes de paiement vers le terminal sur le réseau local. Cette architecture garantit la sécurité : aucune donnée de paiement ne transite sur Internet.

```
Dolibarr (navigateur) → Agent logiciel (localhost:8002) → TPE (réseau local)
```

![Architecture réseau dolibarr - caisse - TPE](screenshots/infrastructure.webp)