> ## 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 transferts

> Comprendre les transferts (Pay-out) dans l'écosystème JEKO

## Vue d'ensemble des transferts

L'API Pay-out (transferts) de JEKO permet de transférer des fonds depuis le compte d'un magasin vers des bénéficiaires. Les transferts peuvent être effectués vers des comptes Mobile Money ou des comptes bancaires.

### Concept clé : Les contacts bénéficiaires

**Avant de pouvoir effectuer un transfert, vous devez d'abord enregistrer le bénéficiaire en tant que contact.** Les contacts sont des bénéficiaires enregistrés qui peuvent recevoir des transferts.

### Flux de transfert

Le processus de transfert suit ces étapes :

1. **Enregistrer un contact** : Créez d'abord un contact bénéficiaire avec les informations de paiement (Mobile Money ou compte bancaire)
2. **Vérifier le solde** : Assurez-vous que le magasin dispose de fonds suffisants
3. **Créer le transfert** : Utilisez le `contactId` pour effectuer le transfert depuis un magasin

### Types de transferts supportés

**Mobile Money :**

* Wave
* Orange Money
* MTN Mobile Money
* Moov Money
* DJAMO

**Comptes bancaires :**

* Virements bancaires via RIB (Relevé d'Identité Bancaire)

### Cas d'usage

Les transferts sont utilisés pour :

* Paiements de salaires
* Paiements aux fournisseurs
* Demandes de retrait d'espèces des clients
* Virements entre entreprises
* Remboursements clients

### Référence partenaire (facultatif)

À la création d’un transfert vous pouvez envoyer un champ optionnel `reference` (5 à 100 caractères) pour votre propre suivi. Il est renvoyé dans les réponses API et les webhooks lorsqu’il est fourni et doit rester unique pour éviter un `409 Conflict` si vous retentez une création déjà réussie.

### Liens avec les magasins

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

### Étapes suivantes

1. **[Enregistrer des contacts bénéficiaires](./beneficiary)** : Apprenez à créer et gérer les contacts
2. **[Intégrer les transferts](./integration)** : Guide complet d'intégration
3. **[Gérer les échecs](./failure-reasons)** : Comprendre les raisons d'échec et comment les gérer