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

# Introduction aux paiements

> Comprendre les différents types de paiements dans l'API JEKO

## Vue d'ensemble

L'API Pay-in (paiements) de JEKO permet de collecter des fonds provenant de clients. L'API JEKO offre **trois cas d'usage de paiement** adaptés à différents scénarios commerciaux.

## Les trois cas d'usage de paiement

### 1. Paiement en magasin

**Utilisation** : Paiements physiques dans un point de vente utilisant un terminal soundbox JEKO.

**Caractéristiques** :

* Nécessite un **deviceId** (identifiant du dispositif soundbox)
* Un QR code est généré et affiché sur le terminal soundbox
* Le client scanne le QR code avec son application de paiement mobile
* La transaction est confirmée directement dans l'application du client

**Cas d'usage** :

* Boutiques physiques
* Restaurants
* Points de vente avec terminal soundbox
* Pour plus de détails : [/api-reference/demandes-de-paiement/créer-une-demande-de-paiement](/api-reference/demandes-de-paiement/créer-une-demande-de-paiement)

### 2. Paiement en ligne (ecommerce / lien de paiement)

**Utilisation** : Paiements en ligne via une page de checkout ou un lien de paiement.

**Caractéristiques** :

* Création d'un **lien de paiement** partageable
* Le client est redirigé vers une page de paiement sécurisée JEKO
* Le client sélectionne son moyen de paiement et confirme la transaction
* Support des liens à usage unique ou réutilisables

**Cas d'usage** :

* Sites e-commerce
* Paiements de factures en ligne
* Collecte de fonds
* Commandes en ligne
* Pour plus de détails : [/api-reference/liens-de-paiement/créer-un-lien-de-paiement](/api-reference/liens-de-paiement/cr%C3%A9er-un-lien-de-paiement)

### 3. Paiement avec redirection (API direct)

**Utilisation** : Paiements intégrés dans votre application mobile ou web avec contrôle de l'expérience utilisateur.

**Caractéristiques** :

* Création d'une **demande de paiement** avec type `redirect`
* Le client est redirigé vers son application de paiement mobile (Wave, Orange Money, Djamo, etc.)
* Le client complète le paiement dans son application familière
* Redirection automatique vers vos URLs de succès/erreur

**Cas d'usage** :

* Applications mobiles
* Applications web avec intégration personnalisée
* Expériences de paiement contrôlées par le développeur
* Pour plus de détails : [/api-reference/demandes-de-paiement/créer-une-demande-de-paiement](/api-reference/demandes-de-paiement/créer-une-demande-de-paiement)

## Flux de paiement commun

Tous les types de paiement suivent ce flux général :

1. **Création de la demande** : Créez une demande de paiement ou un lien de paiement via l'API
2. **Affichage au client** : Présentez le QR code, le lien ou redirigez le client
3. **Confirmation client** : Le client confirme le paiement dans son application
4. **Traitement** : JEKO traite le paiement de manière asynchrone
5. **Notification** : Vous recevez une notification via webhook ou pouvez interroger le statut (pour les demandes de paiement uniquement)

**Note** : Seules les demandes de paiement ont un statut. Pour les liens de paiement, utilisez `canReceivePayments` pour vérifier la disponibilité.

## Liens avec les magasins

**Important** : Tous les paiements doivent être associés à un magasin spécifique via le paramètre `storeId`. Le compte unifié du magasin est crédité lors d'un paiement réussi.

## Méthodes de paiement supportées

Tous les types de paiement supportent les méthodes suivantes :

* **Mobile Money** : Wave, Orange Money, MTN Mobile Money, Moov Money, DJAMO
* **Cartes** : Cartes de débit/crédit (selon disponibilité)

## Étapes suivantes

1. **[Intégration générale](./integration)** : Guide général d'intégration des paiements
2. **[Paiement en magasin](./in-store-payment)** : Détails sur les paiements soundbox
3. **[Paiement en ligne (ecommerce / lien de paiement)](./online-payment)** : Détails sur les liens de paiement
4. **[Paiement avec redirection (API direct)](./in-app-payment)** : Détails sur les paiements redirect
5. **[Gérer les échecs](./failure-reasons)** : Comprendre les raisons d'échec et comment les gérer