L'API Pay-out (transferts) de Kelyko 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 Kelyko (paymentMethod: "Kelyko").
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 Kelyko : un transfert vers un autre magasin Kelyko n'utilise pas POST /partner_api/contacts. Passez paymentMethod: "Kelyko" et destinationStoreId. Le nom du magasin est lu côté serveur. Kelyko 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). Kelyko : utilisez le `destinationStoreId` du magasin destinataire (entreprise différente, pay-with-Kelyko activé).
### Vérifier le solde
Assurez-vous que le magasin source dispose de fonds suffisants pour couvrir le montant et les frais (frais Kelyko : 0).
### Créer le transfert
`POST /partner_api/transfers` avec `storeId` (magasin débiteur) et soit `contactId` / bénéficiaire inline, soit `paymentMethod: "Kelyko"` + `destinationStoreId`.
Chaque étape est détaillée dans Intégrer les transferts.
Les transferts initiés avec une clé plateforme utilisent le barème cash-out du plateforme 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 Kelyko :
- Autre magasin Kelyko (
paymentMethod: "Kelyko",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 Kelyko (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