Introduction aux transferts
Comprendre les transferts (Pay-out) dans l'écosystème Jèko
L'API Pay-out (transferts) de Jèko permet de transférer des fonds depuis le compte d'un magasin vers des bénéficiaires : Mobile Money, compte bancaire, ou un autre magasin Jèko (paymentMethod: "jeko").
Un transfert Mobile Money ou bancaire exige un contact
Pour Wave, Orange, MTN, Moov, DJAMO ou un RIB, le bénéficiaire doit être un contact (contactId, ou bénéficiaire inline qui crée un contact caché). Un contact stocke ses coordonnées de paiement.
Exception JEKO : un transfert vers un autre magasin Jèko n'utilise pas . Passez paymentMethod: "jeko" et destinationStoreId. Le nom du magasin est lu côté serveur. JEKO n'est pas une méthode de contact.
Comment se déroule un transfert
Identifier le bénéficiaire
Mobile Money ou banque : créez un contact (ou passez le bénéficiaire inline). JEKO : utilisez le destinationStoreId du magasin destinataire (entreprise différente, pay-with-Jeko activé).
Vérifier le solde
Assurez-vous que le magasin source dispose de fonds suffisants pour couvrir le montant et les frais (frais JEKO : 0).
Créer le transfert
avec storeId (magasin débiteur) et soit contactId / bénéficiaire inline, soit paymentMethod: "jeko" + destinationStoreId.
Chaque étape est détaillée dans Intégrer les transferts.
Les transferts initiés avec une clé Service Provider utilisent le barème cash-out du Service Provider et ne sont pas remboursables. Voir Tarifs et catalogues.
Où vous pouvez reverser
Mobile Money :
- Wave
- Orange Money
- MTN Mobile Money
- Moov Money
- DJAMO
Comptes bancaires :
- Virements bancaires via RIB (Relevé d'Identité Bancaire)
Portefeuille Jèko :
- Autre magasin Jèko (
paymentMethod: "jeko",destinationStoreId) — synchrone, frais 0. Le destinataire n'a pas à créer de demande de paiement.
À quoi servent les transferts
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
- Paiements harvest / cohortes de magasins Jèko (push, sans QR)
La référence, pour votre suivi
À 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.
Le compte du magasin est débité
Chaque transfert porte un storeId, et le compte de ce magasin est débité une fois le transfert réussi.
Et ensuite
- Enregistrer des contacts bénéficiaires : Apprenez à créer et gérer les contacts
- Intégrer les transferts : Guide complet d'intégration
- Gérer les échecs : Comprendre les raisons d'échec et comment les gérer