> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.pgecom.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 04- Échanger Étape par Étape

# Échanger Étape par Étape

Ce guide couvre le cycle de vie complet des transactions — du placement d'une transaction à son achèvement, incluant les minuteurs, l'annulation, les dépassements de délai de paiement et tout ce qu'il y a entre les deux.

---

## Comprendre le Cycle de Vie des Transactions

Chaque transaction passe par une série d'états dans un **flux d'auto-acceptation simplifié** :

```
Payment Pending → Payment Confirmed → Completed
       ↓                ↓                ↓
  Cancelled        Cancelled        Disputed → Dispute Resolved
       ↓
  Auto-Expired (if payment timeout)
```

| État | Ce Qui Se Passe |
|-------|-------------------|
| **Payment Pending** | Transaction auto-acceptée et fonds verrouillés. L'acheteur doit envoyer le paiement avant l'expiration du minuteur. |
| **Payment Confirmed** | L'acheteur a marqué le paiement comme envoyé et a téléchargé une preuve. Le vendeur doit vérifier avant l'expiration du minuteur. |
| **Completed** | Le vendeur a confirmé la réception du paiement. La transaction est terminée. La crypto est libérée du séquestre. |
| **Cancelled** | Une partie a annulé la transaction. Des frais s'appliquent. |
| **Disputed** | Un litige a été ouvert revendiquant un problème avec la transaction. |
| **Auto-Expired** | Le minuteur de paiement a expiré. Pénalité progressive appliquée (frais + interdiction). |

**Changement Clé** : Les transactions sont **automatiquement acceptées** lorsqu'elles sont placées. Il n'y a plus d'état "Pending" en attente de l'acceptation du vendeur. Les fonds sont immédiatement verrouillés en séquestre et le minuteur de paiement démarre.

La page de détails de la transaction affiche un **suivi de progression visuel** en haut pour que vous sachiez toujours où en est la transaction.

---

## Trouver Vos Transactions

1. Allez dans **Dashboard > Trades**.
2. Vous voyez une liste de toutes les transactions auxquelles vous participez (en tant qu'acheteur ou vendeur).
3. Utilisez la **barre de recherche** pour trouver des transactions par ID, actif, devise ou statut.
4. Basculez le **panneau de filtrage** pour affiner les résultats par :
   - **Status** — Active, Completed, Cancelled, Disputed
   - **Trade Type** — Buy ou Sell
   - **Payment Method** — Filtrer par méthode spécifique
5. Les filtres actifs apparaissent comme des **badges supprimables** au-dessus des résultats.
6. Un comptage de résultats affiche "Showing X of Y trades".
7. Cliquez sur n'importe quelle ligne de transaction pour ouvrir sa page de détails.

---

## Échanger en Tant qu'Acheteur

### Étape 1 — Placer une Transaction

1. Allez dans **Marketplace**.
2. Trouvez une offre **Sell** qui correspond à ce que vous voulez acheter.
3. Cliquez sur **Buy** sur la carte d'offre.
4. Complétez le [dialogue Place Trade en 2 étapes](./02-marketplace.md#placing-a-trade) :
   - Entrez votre montant (dans les limites min/max)
   - Sélectionnez une méthode de paiement
   - Examinez les frais et conditions
   - Confirmez la transaction
5. **La transaction est auto-acceptée immédiatement** et vous êtes redirigé vers la page de détails de la transaction.

> **Important** : Vous devez avoir une **adresse e-mail vérifiée** pour placer des transactions. Consultez le [guide Paramètres et Profil](./10-settings-profile.md) pour la vérification d'e-mail.

### Étape 2 — Envoyer le Paiement (Payment Pending)

**Pas d'attente pour l'acceptation !** La transaction démarre immédiatement en statut **Payment Pending** :

1. Les **coordonnées de paiement du vendeur** apparaissent sur la page de transaction sous "Seller Payment Information".
2. Les détails de paiement varient selon la méthode :
   - **Bank Transfer** — Nom de la banque, numéro de compte, nom du titulaire du compte
   - **Mobile Money** (MonCash, NatCash, M-Pesa, etc.) — Numéro de téléphone, nom du titulaire du compte
   - **Digital Wallet** (PayPal, Venmo, etc.) — E-mail ou nom d'utilisateur
   - **Cash** — Lieu de rencontre, coordonnées
3. Le **minuteur de paiement** commence le compte à rebours (généralement 15 minutes, défini par le créateur de l'offre).
4. Envoyez le paiement **en dehors de la plateforme** en utilisant les détails fournis.
5. Vous devez compléter le paiement avant l'expiration du minuteur ou faire face à des **pénalités progressives** (voir [Dépassements de Délai de Paiement](#payment-timeouts) ci-dessous).

> **Couleurs d'Avertissement du Minuteur** :
> - **Bleu** — Beaucoup de temps restant
> - **Orange** — Moins de 5 minutes restantes — urgent
> - **Rouge** — Le minuteur a expiré

### Étape 3 — Télécharger la Preuve de Paiement

1. Sur la page de détails de la transaction, cliquez sur **Mark Payment as Sent**.
2. Choisissez comment fournir la preuve :
   - **Upload Image** — Glissez-déposez ou cliquez pour télécharger une capture d'écran de votre reçu de paiement (JPEG, PNG, WebP, GIF — max 10MB). Les images sont automatiquement optimisées.
   - **Enter URL** — Collez un lien vers votre image de reçu ou entrez un ID de référence de transaction.
3. Ajoutez éventuellement des notes sur le paiement.
4. Cliquez sur **Submit Payment Proof**.

Le statut passe à **Payment Confirmed** et le **minuteur de libération** démarre pour le vendeur.

### Étape 4 — Attendre la Confirmation

Le vendeur vérifie que votre paiement a été reçu. Une fois qu'il confirme, la transaction se termine automatiquement. Vous verrez une **animation de confettis** et une bannière de succès.

> **Astuce** : Utilisez le [chat de transaction](./08-trade-chat.md) pour communiquer avec le vendeur s'il y a des questions sur le paiement.

---

## Échanger en Tant que Vendeur

### Étape 1 — Recevoir une Transaction

Lorsque quelqu'un place une transaction sur votre offre :
- Elle apparaît immédiatement dans **Dashboard > Trades** avec le statut **Payment Pending**
- **Les fonds sont auto-verrouillés** en séquestre
- Le **minuteur de paiement** démarre immédiatement
- Vous pouvez recevoir une notification par e-mail (si activé)

**Aucune étape d'acceptation nécessaire** — la transaction est prête pour que l'acheteur paie.

### Étape 2 — Attendre le Paiement

L'acheteur voit vos coordonnées de paiement sauvegardées (configurées lorsque vous avez créé l'offre) et envoie le paiement. Le **minuteur de paiement** fait le compte à rebours.

Vous pouvez :
- **Prolonger le minuteur de paiement** si l'acheteur a besoin de plus de temps (voir [Prolonger les Minuteurs](#extending-timers))
- **Annuler la transaction** si nécessaire (frais de 2% s'appliquent - voir [Annuler une Transaction](#cancelling-a-trade))
- **Chatter avec l'acheteur** pour des mises à jour

### Étape 3 — Examiner la Preuve de Paiement

Lorsque l'acheteur marque le paiement comme envoyé :
1. Le statut passe à **Payment Confirmed**
2. Le **minuteur de libération** démarre (généralement 30 minutes, défini lorsque vous avez créé l'offre)
3. La preuve de paiement apparaît sur la page de détails de la transaction
4. Cliquez sur l'image pour la voir en taille réelle

### Étape 4 — Vérifier et Confirmer

1. **Vérifiez votre banque/portefeuille/téléphone** pour confirmer que le paiement a réellement été reçu.
2. Examinez la preuve de paiement de l'acheteur sur la page de détails de la transaction.
3. Si le paiement est reçu, cliquez sur **Confirm Payment Received**.
4. La transaction se termine avec une **animation de confettis**.
5. La crypto est libérée du séquestre vers l'acheteur.

> **Avertissement** : Confirmez uniquement le paiement après avoir vérifié que les fonds sont réellement dans votre compte. Une fois confirmé, la transaction ne peut pas être inversée.

> **Important** : Vous devez confirmer avant l'expiration du minuteur de libération ou l'acheteur peut ouvrir un appel.

---

## Minuteurs de Paiement

Les transactions ont **deux minuteurs** qui imposent des délais pour maintenir les transactions en mouvement rapide et prévenir les pertes de temps.

### Minuteur de Paiement

- **Démarre** : Immédiatement lorsque la transaction est placée (auto-acceptée)
- **Qui** : L'acheteur doit envoyer le paiement et télécharger la preuve avant l'expiration
- **Par défaut** : 15 minutes (configurable par le créateur de l'offre : 15, 30, 60 ou minutes personnalisées)
- **Affiché** : Bannière compacte avec compte à rebours en haut de la page de transaction
- **Que se passe-t-il si expiré** : Voir [Dépassements de Délai de Paiement](#payment-timeouts) ci-dessous

### Minuteur de Libération

- **Démarre** : Lorsque l'acheteur marque le paiement comme envoyé (le statut devient Payment Confirmed)
- **Qui** : Le vendeur doit confirmer la réception du paiement avant l'expiration
- **Par défaut** : 30 minutes (configurable par le créateur de l'offre : 15, 30, 60 ou minutes personnalisées)
- **Affiché** : Bannière compacte avec compte à rebours en haut de la page de transaction
- **Que se passe-t-il si expiré** : L'acheteur peut ouvrir un litige/appel

### Couleurs des Minuteurs

| Couleur | Signification |
|-------|---------|
| **Bleu** | Plus de 5 minutes restantes |
| **Orange** | Moins de 5 minutes restantes — action urgente nécessaire |
| **Rouge** | Le minuteur a expiré |

> **Auto-rafraîchissement** : Les minuteurs se mettent à jour toutes les 15 secondes pour que les deux parties voient toujours le compte à rebours actuel.

---

## Prolonger les Minuteurs

Chaque partie peut prolonger le minuteur pour donner plus de temps à l'autre partie, jusqu'à un **maximum de 7 jours au total** depuis la création de la transaction.

### Prolongation du Minuteur de Paiement (Le Vendeur Prolonge pour l'Acheteur)

Le **vendeur** peut prolonger le minuteur de paiement si l'acheteur a besoin de plus de temps pour payer.

**Options de Prolongation** :
- 15 minutes
- 30 minutes
- 1 heure (60 minutes)
- 1 jour (24 heures / 1440 minutes)
- 3 jours (72 heures / 4320 minutes)
- 5 jours (120 heures / 7200 minutes)

**Comment prolonger** :
1. Cliquez sur le menu déroulant **"Extend Timer"** à côté de la bannière du minuteur de paiement
2. Sélectionnez votre temps de prolongation souhaité
3. Confirmez la prolongation

**Limites** :
- Temps total maximum depuis la création de la transaction jusqu'au délai : **7 jours**
- Si l'ajout de la prolongation dépasse 7 jours, vous verrez une erreur avec la prolongation maximale autorisée
- Les prolongations sont suivies (le compteur montre combien de fois prolongé)

### Prolongation du Minuteur de Libération (L'Acheteur Prolonge pour le Vendeur)

**L'acheteur** peut prolonger le minuteur de libération si le vendeur a besoin de plus de temps pour confirmer le paiement.

- Mêmes options et limites de prolongation que le minuteur de paiement
- Même limite de temps total maximum de 7 jours

### Messages Système

Lorsqu'un minuteur est prolongé, les deux parties reçoivent un **message système** dans le chat de transaction montrant :
- Qui a prolongé le minuteur
- Combien de temps a été ajouté
- Nouvel horodatage du délai

---

## Dépassements de Délai de Paiement

Si un **acheteur** ne parvient pas à envoyer le paiement avant l'expiration du minuteur de paiement, le système applique automatiquement des **pénalités progressives** pour décourager les récidivistes.

### Ce Qui Se Passe

Lorsque le délai de paiement est atteint et que le paiement n'a pas été marqué comme envoyé :

1. **La transaction est auto-annulée** (le statut devient "cancelled", `autoExpired: true`)
2. **Des frais de dépassement sont facturés** (progressifs selon le nombre d'infractions)
3. **50% des frais vont au vendeur** en compensation de son temps
4. **Une interdiction d'échange est appliquée** (durée progressive)
5. **Des notifications par e-mail sont envoyées** aux deux parties

### Système de Pénalités Progressives

Les pénalités augmentent à chaque infraction de dépassement :

| Infraction # | Montant des Frais | Le Vendeur Reçoit | La Plateforme Reçoit | Durée de l'Interdiction |
|-----------|------------|-------------|---------------|--------------|
| **1ère** | **$3.99 USD** | $1.995 USD | $1.995 USD | **24 heures** |
| **2ème** | **$7.99 USD** | $3.995 USD | $3.995 USD | **48 heures** |
| **3ème+** | **$15.99 USD** | $7.995 USD | $7.995 USD | **1 semaine (168 heures)** |

### Comment les Frais Sont Facturés

**Si l'acheteur a un solde USD suffisant** :
- Les frais sont déduits automatiquement du portefeuille de l'acheteur
- Le vendeur reçoit sa part de 50% immédiatement
- La transaction apparaît dans les historiques de portefeuille des deux

**Si l'acheteur a un solde insuffisant** :
- **Une dette est créée** pour le montant total
- L'acheteur ne peut pas placer de nouvelles transactions tant que la dette n'est pas payée
- Aucun argent n'est transféré au vendeur tant que la dette n'est pas payée
- Consultez le [guide Portefeuille](./07-wallet.md) pour payer la dette

### Interdictions d'Échange

Pendant l'interdiction, les acheteurs **NE PEUVENT PAS** :
- ❌ Placer de nouvelles transactions
- ❌ Accepter des offres d'échange
- ❌ Initier des transactions d'achat

Pendant l'interdiction, les acheteurs **PEUVENT** :
- ✅ Voir les transactions existantes
- ✅ Compléter les transactions en cours (s'il y en a)
- ✅ Chatter avec les partenaires d'échange
- ✅ Déposer des fonds dans le portefeuille
- ✅ Payer les dettes en cours
- ✅ Soumettre des appels (avec frais de $4.99)

L'expiration de l'interdiction est affichée dans les messages d'erreur et les alertes du tableau de bord.

### Prévenir les Dépassements

**En tant qu'acheteur** :
- Placez des transactions uniquement lorsque vous êtes prêt à payer immédiatement
- Ayez la méthode de paiement prête avant de cliquer sur "Buy"
- Si vous avez besoin de plus de temps, demandez au vendeur de prolonger le minuteur via le chat
- Définissez des rappels de calendrier pour les transactions actives

**En tant que vendeur** :
- Définissez des limites de temps de paiement raisonnables (15-30 minutes typiques)
- Soyez disponible pour prolonger le minuteur si l'acheteur a des retards légitimes
- Surveillez les transactions et communiquez de manière proactive

### Appels

Si un dépassement s'est produit en raison de :
- ✅ Le paiement a été effectué mais pas confirmé
- ✅ Des problèmes techniques ont empêché le téléchargement du paiement
- ✅ Le vendeur a fourni de mauvaises informations de paiement
- ✅ Circonstances atténuantes (urgence, etc.)

Vous pouvez soumettre un **appel** avec des frais de $4.99 (remboursés si approuvés). Consultez le [guide Litiges et Appels](./06-disputes-appeals.md) pour le processus d'appel complet.

> **En Savoir Plus** : Consultez [Payment Timeout System](../PAYMENT_TIMEOUT_SYSTEM.md) pour la documentation complète incluant les analyses, le suivi des dettes et les outils d'administration.

---

## Annuler une Transaction

Chaque partie peut annuler une transaction pendant certains états, mais **des frais s'appliquent** pour décourager les abus.

### Quand Pouvez-vous Annuler ?

- ✅ Pendant **Payment Pending** — L'acheteur et le vendeur peuvent annuler
- ✅ Pendant **Payment Confirmed** — **Uniquement l'acheteur** peut annuler (le vendeur ne peut pas, car l'acheteur peut avoir déjà envoyé de l'argent)
- ❌ **Non disponible** après achèvement, ou si déjà contesté
- ❌ **Non disponible** après l'expiration du minuteur — utilisez un appel à la place

### Frais d'Annulation

| Qui Annule | Frais | Détails |
|-------------|-----|---------|
| **Acheteur** | **$3.99 USD** | $1.995 vont au vendeur en compensation, $1.995 à la plateforme |
| **Vendeur** | **2% du montant de la transaction** | Déduit de la crypto remboursée |

**Exemple Acheteur** :
- Montant de la transaction : 0.5 BTC d'une valeur de $15,000 USD
- L'acheteur annule
- L'acheteur est facturé : $3.99 USD (frais fixes)
- Le vendeur reçoit : $1.995 USD (compensation)
- La plateforme reçoit : $1.995 USD

**Exemple Vendeur** :
- Montant de la transaction : 0.5 BTC
- Le vendeur annule
- Frais d'annulation : 0.01 BTC (2% de 0.5 BTC)
- Le vendeur reçoit un remboursement : 0.49 BTC (0.5 - 0.01 frais)
- La plateforme reçoit : 0.01 BTC

### Comment Annuler

1. Sur la page de détails de la transaction, cliquez sur le bouton **Cancel Trade**.
2. Lisez les informations sur les frais affichées.
3. Entrez une **raison d'annulation** (requise).
4. Cliquez sur **Yes, Cancel Trade** pour confirmer.
5. Les frais sont facturés et les fonds en séquestre sont remboursés (moins les frais du vendeur le cas échéant).

### Que Se Passe-t-il Après l'Annulation

1. Le **statut de la transaction** passe à "Cancelled"
2. Les **frais d'annulation** sont facturés immédiatement
3. Les **fonds en séquestre** sont déverrouillés et remboursés (moins les frais pour le vendeur)
4. Un **message système** est publié dans le chat de transaction
5. Une **notification par e-mail** est envoyée à l'autre partie
6. Un **événement de timeline** est ajouté montrant qui a annulé et pourquoi

---

## Consulter les Détails de Transaction

La page de détails de la transaction organise les informations en sections d'accordéon repliables :

### Détails de Transaction
- Statut de la transaction et statut du séquestre
- Actif échangé
- Montant et prix par unité
- Devise et méthode de paiement
- Valeur totale de la transaction
- **Minuteur de paiement** (si en statut Payment Pending)
- **Minuteur de libération** (si en statut Payment Confirmed)

### Informations Acheteur / Vendeur
- Nom et e-mail de l'acheteur (avec badge "You" si vous êtes l'acheteur)
- Nom et e-mail du vendeur (avec badge "You" si vous êtes le vendeur)
- Boutons **Block** / **Unblock** pour l'autre partie

### Informations de Paiement du Vendeur
- Les coordonnées de paiement fournies par le vendeur (rendues selon le type de paiement)
- Les types de champs varient : numéros de téléphone, comptes bancaires, e-mails, emplacements physiques
- Boutons de copie pour une copie facile

### Preuve de Paiement
- Aperçu d'image (cliquable pour voir en taille réelle) si la preuve a été téléchargée
- Référence texte si une URL ou un ID de transaction a été fourni
- "Payment proof hasn't been submitted yet" si aucune preuve n'existe

### Timeline de Transaction
- Historique complet des événements avec horodatages
- Chaque changement d'état, action et événement est enregistré
- Prolongations de minuteur, facturations de frais et applications d'interdiction enregistrées

### Chat de Transaction
- Messagerie en temps réel avec l'autre partie
- Consultez le [guide Chat de Transaction](./08-trade-chat.md) pour tous les détails

> **Astuce** : Cliquez sur les en-têtes de section pour les développer ou les replier.

---

## Exigence de Vérification d'E-mail

Pour protéger la plateforme contre les abus et assurer la sécurité du compte, vous **devez vérifier votre adresse e-mail** avant de pouvoir :

- ❌ Placer des transactions (acheter sur le marché)
- ❌ Créer des offres d'échange (vendre sur le marché)

### Comment Vérifier Votre E-mail

1. Allez dans l'onglet **Dashboard > Settings > Security**
2. Cliquez sur le bouton **Send Code**
3. Vérifiez votre e-mail pour un code de vérification à 6 chiffres (expire en 10 minutes)
4. Entrez le code dans le champ de vérification
5. Cliquez sur **Verify**
6. E-mail vérifié ✅ — vous pouvez maintenant échanger !

**La vérification d'e-mail garantit** :
- La confirmation de la propriété du compte
- La possibilité de récupérer votre compte
- Recevoir des notifications importantes (alertes de dépassement, mises à jour de transaction, etc.)
- Requis pour activer l'authentification à deux facteurs (2FA)

Consultez le [guide Paramètres et Profil](./10-settings-profile.md) pour plus de détails sur la vérification d'e-mail et les fonctionnalités de sécurité.

---

## Mode Visualiseur

Si vous êtes un **admin**, **propriétaire** ou **viewer** d'équipe surveillant une transaction dont vous ne faites pas directement partie, vous voyez la transaction en **mode lecture seule** :

- Tous les boutons d'action sont désactivés
- Le chat est en lecture seule (vous pouvez voir les messages mais pas en envoyer)
- Vous pouvez voir tous les détails de la transaction mais ne pouvez effectuer aucune action
- Utile pour le support client, la conformité et la surveillance d'équipe

---

## Référence Rapide

### États des Transactions

| État | Action Acheteur | Action Vendeur |
|-------|--------------|---------------|
| Payment Pending | Envoyer le paiement et télécharger la preuve | Attendre ou prolonger le minuteur |
| Payment Confirmed | Attendre la confirmation du vendeur | Vérifier le paiement et confirmer |
| Completed | Noter le vendeur (optionnel) | Noter l'acheteur (optionnel) |
| Cancelled | N/A | N/A |
| Disputed | Fournir des preuves | Fournir des preuves |

### Boutons d'Action par Rôle

| Action | Acheteur | Vendeur | Quand Disponible |
|--------|-------|--------|----------------|
| Mark Payment Sent | ✅ | ❌ | Payment Pending |
| Confirm Payment | ❌ | ✅ | Payment Confirmed |
| Extend Payment Timer | ❌ | ✅ | Payment Pending |
| Extend Release Timer | ✅ | ❌ | Payment Confirmed |
| Cancel Trade | ✅ | ✅ | Payment Pending ou Payment Confirmed (acheteur uniquement) |
| Open Dispute | ✅ | ✅ | Payment Confirmed ou après expiration du minuteur |

---

## Guides Connexes

- [Guide Marché](./02-marketplace.md) — Trouver et filtrer les offres
- [Guide Création d'Offres](./03-creating-offers.md) — Configurer vos offres de vente
- [Guide Paiements](./05-payments.md) — Méthodes de paiement et vérification
- [Guide Litiges et Appels](./06-disputes-appeals.md) — Gérer les problèmes et les appels
- [Guide Portefeuille](./07-wallet.md) — Gérer les fonds et payer les dettes
- [Guide Chat de Transaction](./08-trade-chat.md) — Communiquer avec les partenaires d'échange
- [Payment Timeout System](../PAYMENT_TIMEOUT_SYSTEM.md) — Documentation complète sur les pénalités progressives

---

**Dernière Mise à Jour** : Février 2026
**Version** : 2.0.0 — Auto-Acceptation et Pénalités Progressives
