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

# Marketplace

> Pour gérer les paiements entre acheteurs et vendeurs avec redistribution automatique

L’API Marketplace permet aux plateformes d’orchestrer les paiements entre acheteurs et vendeurs.\
Elle gère la création d’ordres de paiement, la distribution des fonds, les commissions, et les redirections.

### Flux de Paiement Marketplace

```plaintext theme={null}
Acheteur              Marketplace                       Lygos                     Vendeur
  |                         |                               |                           |
  |-----(1) Achat---------> |                               |                           |
  |                         |----(2) Créer Transaction----->|                           |
  |                         | <-----(3) URL Checkout--------|                           |
  |<--(4) Redirection------ |                               |                           |
  |--------------------(5) Paiement-----------------------> |                           |
  |<--------------(6) Redirection selon Statut------------- |                           |

Si le paiement de l'acheteur a bien été effecué :

  |                         |                               |---(7) Paiement Vendeur -->|
  |                         |<---(8) Paiement Commission----|                           |
  |                         |<---(9) Notification de Vente--|                           |
```

1. **Création d’un achat**\
   L’acheteur sélectionne un produit. La plateforme crée un ordre marketplace via Lygos, incluant :
   * le montant total,
   * la part vendeur,
   * la commission de la plateforme,
   * les URLs de redirection.

2. **Création de l’Order Marketplace**\
   Lygos enregistre l’ordre et renvoie une URL de paiement (checkout).

3. **Redirection vers le Checkout Lygos**\
   La plateforme redirige l’acheteur vers la page de paiement.

4. **Saisie et validation du paiement**\
   L’acheteur saisit ses informations (Mobile Money, carte, etc.) et valide.

5. **Débit de l’acheteur**\
   Lygos envoie la demande de paiement au fournisseur Mobile Money ou bancaire.

6. **Validation**\
   Une fois confirmé, Lygos reçoit le statut (succès, échec, pending).

7. **Distribution automatique (Split Payment)**\
   Si succès :
   * Paiement de la part **vendeur** sur son wallet / compte bancaire,
   * Paiement de la **commission** à la plateforme,
   * Conservation éventuelle de frais par Lygos.

8. **Notifcation**\
   La marketplace reçoit une notication que la transaction a bien été effectuée.

<Card title="Créer un paiement via API Marketplace" icon="square-code" href="/api-reference/marketplace/create-gateway">
  Gérez vos vendeurs, paiements et commissions avec Lygos.
</Card>