> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bizconnectpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Historique & Gestion des Transactions

> Suivez, analysez et exportez l'ensemble de vos flux financiers avec une traçabilité complète.

L'écran **Transactions** offre un journal d'audit exhaustif et immuable de chaque mouvement financier réalisé sur votre compte marchand.

***

## Types de transactions

Chaque écriture financière est catégorisée par type d'opération :

* `COLLECTION` : Paiement entrant réglé par un client (via lien de paiement, checkout API ou intégration boutique).
* `PAYOUT` : Décaissement sortant vers un compte Mobile Money ou un compte bancaire.
* `REFUND` : Remboursement total ou partiel octroyé à un client.
* `TRANSFER` : Virement interne entre portefeuilles de devises différentes.
* `CARD_FUNDING` : Approvisionnement d'une carte virtuelle depuis votre solde principal.
* `NOTIFICATION_PLAN_SUBSCRIPTION` : Souscription ou renouvellement automatique d'un forfait de notifications (référence sous le format `SUB-XXXXXXXX`).

***

## Statuts d'une transaction

| Statut | Description |
| :- | :- |
| `PENDING` | Opération initiée, en attente de validation par le payeur sur son mobile ou sa banque. |
| `PROCESSING` | Transaction prise en charge par le switch opérateur télécom ou le réseau bancaire. |
| `REQUIRES_ACTION` | Le payeur doit terminer une action, par exemple ouvrir un lien de paiement externe. |
| `COMPLETED` | Le fournisseur a confirmé la réussite de la transaction. |
| `FAILED` | Le fournisseur a confirmé l'échec de la transaction. Consultez le motif dans le détail. |
| `UNKNOWN` | Le résultat n'est pas encore confirmé. Vérifiez à nouveau et rapprochez la référence fournisseur. |
| `CANCELLED` | L'opération a été annulée avant son achèvement. |
| `EXPIRED` | Le délai de traitement est dépassé ; la transaction n'est pas réussie. |
| `RECONCILIATION_REQUIRED` | Une vérification manuelle est nécessaire avant de confirmer le résultat financier. |

Les payouts peuvent aussi passer par `VALIDATING`, `FUNDS_LOCKED` et `SUBMITTED`. Sur la transaction normalisée, les deux premières correspondent à `PENDING`, tandis que `SUBMITTED` correspond à `PROCESSING`. Consultez [les statuts détaillés des pay-ins et payouts](../api-reference/transactions/statuses) pour les définitions et les actions recommandées.

***

## Recherche avancée et filtres

Pour faciliter vos rapprochements comptables, vous disposez d'un moteur de filtrage multicritères :

* **Période** : Aujourd'hui, 7 derniers jours, 30 derniers jours, mois en cours ou dates personnalisées.
* **Statut** : Visualisez uniquement les succès, les échecs ou les opérations en attente.
* **Type d'opération** : Isolez les collectes, les retraits ou les souscriptions.
* **Opérateur / Méthode** : MTN MoMo, Orange Money, Carte Visa, Mastercard.
* **Référence & ID de corrélation** : Retrouvez instantanément une transaction grâce à son identifiant unique, son `transaction_id` ou sa référence externe.

***

## Détail et reçu de transaction

En cliquant sur n'importe quelle ligne de la liste des transactions, un panneau latéral détaille :

* L'horodatage exact à la seconde près.
* Le montant brut payé par le client et les frais de passerelle déduits.
* Le montant net crédité sur votre portefeuille.
* Les métadonnées client (numéro masqué, adresse email, adresse IP).
* L'identifiant de corrélation (`correlation_id`) indispensable pour les demandes d'assistance au support technique.
* Un bouton d'impression ou de téléchargement du reçu officiel au format PDF.

***

## Export des rapports

Vous pouvez exporter votre historique au format **CSV** ou **Excel (XLSX)** pour intégration directe dans votre logiciel de comptabilité (Sage, Odoo, QuickBooks, Excel).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.