Les APIs Pay-in & Pay-out développées par JEKO ont des modes de fonctionnement distincts. Toutes les opérations doivent être associées à un magasin via son identifiant (storeId).
L’API Pay-out (transferts) permet de transférer des fonds à un tiers : la transaction est de type débit. Les fonds sont automatiquement envoyés au destinataire sans nécessiter d’interaction de sa part.Fonctionnement :
Le compte du magasin doit être provisionné au préalable pour pouvoir effectuer des transferts via l’API JEKO
Avant de procéder au transfert, JEKO vérifie si le magasin possède les fonds nécessaires et les réserve le temps que l’opérateur confirme le transfert effectif des fonds au destinataire
Les transferts peuvent être effectués vers des comptes Mobile Money (Wave, Orange Money, MTN, Moov, DJAMO) ou vers des comptes bancaires
Important : Chaque transfert doit être associé à un magasin spécifique via le paramètre storeId
Méthodes de paiement supportées :
Mobile Money : Wave, Orange Money, MTN Mobile Money, Moov Money, DJAMO
Transferts bancaires : via RIB (Relevé d’Identité Bancaire)
L’API Pay-in (paiements) permet la collecte de fonds provenant d’un tiers (client final) : la transaction est de type crédit. L’interaction du client est nécessaire ici, puisqu’il doit confirmer la transaction selon le type d’intégration :1. Paiement en magasin (Soundbox) :
Un QR code est généré et affiché sur le terminal soundbox JEKO
Le client scanne le QR code avec son application de paiement mobile
La transaction est confirmée directement dans l’application du client
2. Paiement en ligne (Payment Links) :
Un lien de paiement est généré et partagé avec le client
Le client est redirigé vers une page de paiement sécurisée
Le client sélectionne son moyen de paiement et confirme la transaction
3. Paiement en application (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
Le client est redirigé vers votre application via les URLs de succès/erreur
Important : Chaque paiement doit être associé à un magasin spécifique via le paramètre storeId. Après authentification de la transaction, le montant est crédité sur le compte unifié du magasin. Les fonds collectés peuvent ensuite être utilisés pour effectuer des transferts (pay-out) depuis le même compte.
Chaque magasin possède un compte unifié qui gère à la fois les opérations de pay-in et de pay-out :
Pay-in : Le compte est crédité automatiquement lors des paiements réussis
Pay-out : Le compte est débité automatiquement lors des transferts réussis
Cette architecture unifiée permet une gestion simplifiée des fonds : les paiements reçus peuvent être immédiatement utilisés pour effectuer des transferts, sans séparation entre comptes de collecte et de transfert.
Toutes les transactions créées sur l’API JEKO sont traitées de façon asynchrone. Une fois acceptée, les paramètres d’une requête de transaction sont enregistrés dans une file d’attente de transactions à traiter et sont ensuite gérés par les autres composants de l’infrastructure JEKO.Ce mode de fonctionnement présente plusieurs avantages :
Capacité de répondre très rapidement à l’émetteur de la requête HTTP
Réduction du temps d’attente côté plateforme marchand
