Skip to main content

​
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 (Soundbox)

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

​
2. Paiement en ligne / E-commerce

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

​
3. Paiement en application (In-App)

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

​
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 : Guide général d’intégration des paiements
  2. Paiement en magasin : Détails sur les paiements soundbox
  3. Paiement en ligne : Détails sur les liens de paiement
  4. Paiement en application : Détails sur les paiements redirect
  5. Gérer les échecs : Comprendre les raisons d’échec et comment les gérer