Skip to main content

​
Section 5 — Business, Commandes & Paiements

Rôles concernés
  • Tableau de bord business / Gestion de stock : Editeur, Admin, Super Admin
  • Commandes et Transactions : Editeur, Admin, Super Admin
  • Processus d’achat (checkout) : tous les utilisateurs connectés

​
1. Tableau de Bord Business

​
1.1 Présentation générale

La section Business regroupe trois outils de suivi accessibles depuis le Hub via une barre d’onglets commune :
Note : la page https://hub.editions.oya.africa/business redirige automatiquement vers https://hub.editions.oya.africa/inventory.
[CAPTURE D’ÉCRAN: Barre d’onglets du tableau de bord business avec les trois onglets “Gestion de stock”, “Historique des achats”, “Transactions”]

​
1.2 Accéder au tableau de bord

  1. Connectez-vous à votre compte sur la plateforme Oya Editions.
  2. Dans la navigation principale, cliquez sur Mon espace (Hub).
  3. Dans la barre latérale ou les raccourcis, accédez à l’un des onglets Business.
  4. Si vous ne disposez pas des droits suffisants (rôle Editeur minimum requis), vous serez redirigé vers la page d’accueil du Hub.
Prérequis : Vous devez avoir un rôle Editeur, Admin ou Super Admin sur l’organisation active (membership) pour accéder aux pages Business.

​
1.3 Gestion de stock (Inventaire)

L’onglet Gestion de stock (https://hub.editions.oya.africa/inventory) permet de visualiser et mettre à jour le stock physique de vos ouvrages, ventilé par pays. Métriques affichées :
  • Stock total disponible par ouvrage
  • Quantité réservée (commandes en cours)
  • Quantité vendue (historique)
  • Seuil d’alerte bas (lowStockThreshold) configurable
  • Ventes par pays avec indicateur de devise locale
[CAPTURE D’ÉCRAN: Page inventaire avec la liste des ouvrages et leurs stocks par pays] Créer un inventaire :
  1. Cliquez sur le bouton Créer un inventaire (coin supérieur droit).
  2. Vous serez redirigé vers https://hub.editions.oya.africa/inventory/new.
  3. Renseignez les informations d’inventaire (titre, prix, pays disponibles, quantités par pays, seuil d’alerte).
  4. Validez le formulaire pour enregistrer l’inventaire.
Modifier un stock existant :
  1. Dans la liste, repérez l’ouvrage concerné.
  2. Cliquez sur l’icône Modifier le stock sur la ligne de l’ouvrage.
  3. Un formulaire de modification s’ouvre, permettant de répartir les quantités disponibles par pays.
  4. Enregistrez. Une notification de succès confirmera la mise à jour.
Exporter les données d’inventaire : Cliquez sur le bouton Exporter pour télécharger les données de stock au format tabulaire. [CAPTURE D’ÉCRAN: Formulaire d’ajout/modification de stock avec ventilation par pays]

​
2. Mes Commandes (Historique des achats)

​
2.1 Accéder à la liste des commandes

  1. Depuis le Hub, cliquez sur l’onglet Historique des achats.
  2. L’URL est https://hub.editions.oya.africa/orders.
  3. La page charge toutes les commandes de l’organisation (jusqu’à 100 commandes, triées par date décroissante).
Si aucune commande n’a encore été passée, un écran vide s’affiche avec le message “Les achats de vos clients apparaîtront ici”. [CAPTURE D’ÉCRAN: Page “Historique des achats” avec le tableau des commandes et les statistiques en haut]

​
2.2 Métriques affichées (Statistiques)

En haut de la page, quatre indicateurs clés sont présentés : Un tableau Ventes par pays affiche, pour chaque pays : le drapeau, le nombre de commandes, le nombre d’exemplaires et le chiffre d’affaires dans la devise locale. [CAPTURE D’ÉCRAN: Cartes de statistiques commandes (Total, Payées, Livraisons, Revenus)]

​
2.3 Filtrer et rechercher des commandes

La section de filtres permet d’affiner la liste :
  1. Recherche libre : saisissez un numéro de commande (ex: CMD-12), un nom de client ou un titre d’ouvrage dans le champ de recherche.
  2. Filtre par statut de paiement : sélectionnez dans le menu déroulant parmi :
    • Tous les statuts
    • En attente (pending)
    • Payé (paid)
    • Échoué (failed)
    • Remboursé (refunded)
  3. Filtre par statut de livraison : sélectionnez dans le menu déroulant parmi :
    • Toutes les livraisons
    • En attente (pending)
    • En préparation (processing)
    • Expédié (shipped)
    • Livré (delivered)
    • Annulé (cancelled)
Les filtres s’appliquent en temps réel, sans rechargement de page. [CAPTURE D’ÉCRAN: Section filtres avec les trois champs de recherche et sélecteurs de statut]

​
2.4 Tableau des commandes

Le tableau présente les colonnes suivantes pour chaque commande : [CAPTURE D’ÉCRAN: Tableau des commandes avec une ligne exemple et le badge de statut de livraison]

​
2.5 Détail d’une commande

  1. Sur la ligne d’une commande, cliquez sur l’icône Voir (oeil).
  2. Une modale s’ouvre avec le détail complet, organisé en sections :
Informations client
  • Nom complet
  • Adresse e-mail
  • Numéro de téléphone
Ouvrage commandé
  • Titre et auteur
  • Quantité
  • Prix unitaire et total
Paiement
  • Statut du paiement (badge coloré)
  • Méthode de paiement
  • Date de paiement (si applicable)
Livraison
  • Statut de livraison (badge coloré)
  • Numéro de suivi (TRK-{id})
Adresse de livraison
  • Pays (avec drapeau)
  • Adresse complète
Chronologie
  • Date de passage de la commande
  • Date de paiement (si payé)
  • Date d’expédition (si expédié)
  • Date de livraison (si livré)
[CAPTURE D’ÉCRAN: Modale de détail d’une commande avec toutes les sections]

​
2.6 Exporter les commandes

Depuis la liste des commandes, cliquez sur le bouton Exporter (en haut à droite) pour télécharger les données.

​
2.7 Statuts des commandes

Statuts de paiement : Statuts de livraison :

​
3. Mes Transactions

​
3.1 Accéder à l’historique des transactions

  1. Depuis le Hub, cliquez sur l’onglet Transactions.
  2. L’URL est https://hub.editions.oya.africa/transactions.
  3. La page charge toutes les transactions enregistrées, avec la pagination fournie par l’API.
Si aucune transaction n’existe, un message “Il n’y a pas encore de transactions enregistrées” s’affiche. [CAPTURE D’ÉCRAN: Page “Transactions” avec les quatre cartes de métriques et la liste des transactions]

​
3.2 Métriques des transactions

Quatre indicateurs sont affichés en haut de page : [CAPTURE D’ÉCRAN: Cartes de métriques des transactions (Total, Revenu, En Attente, Taux de réussite)]

​
3.3 Filtrer et rechercher des transactions

  1. Recherche libre : saisissez un ID de transaction externe (identifiant CinetPay), un titre de publication ou un nom de client dans le champ de recherche.
  2. Filtre par statut : sélectionnez dans le menu déroulant parmi :
    • Tous les statuts
    • En attente (pending)
    • Complété (completed)
    • Échoué (failed)
    • Annulé (cancelled)
Les filtres s’appliquent immédiatement sur la liste affichée. Un compteur en bas de page indique le nombre de transactions visibles par rapport au total paginé. [CAPTURE D’ÉCRAN: Champ de recherche et sélecteur de statut de la page transactions]

​
3.4 Tableau des transactions

Le tableau présente les colonnes suivantes : [CAPTURE D’ÉCRAN: Tableau des transactions avec une ligne exemple]

​
3.5 Types et statuts de transactions

Statuts de transaction :
Les transactions passent de pending à completed ou failed automatiquement via les notifications webhook CinetPay. Ce processus est entièrement automatique.

​
3.6 Détail d’une transaction

  1. Cliquez sur l’icône Voir (oeil) sur la ligne d’une transaction.
  2. Une boîte de dialogue s’ouvre avec :
Informations principales
  • Statut (badge)
  • Gateway de paiement
  • Montant et devise
  • Date de création
Informations client
  • Nom complet et ID client
Détails de la commande
  • Titre de la publication et ID interne
  • Quantité, prix unitaire, montant total
Snapshot de l’inventaire (si disponible)
  • ID inventaire, type (Numérique / Physique)
  • Prix au moment de la vente
  • Quantité disponible au moment de la vente
Données webhook (si disponibles, fournies par CinetPay)
  • Méthode de paiement (ex: Mobile Money)
  • Numéro de téléphone utilisé (avec indicatif)
  • Date de la transaction CinetPay
  • Message d’erreur éventuel
Informations système
  • URL de notification (notify URL)
  • URL de paiement CinetPay
  • Dates de création et de dernière mise à jour
[CAPTURE D’ÉCRAN: Dialogue de détail d’une transaction ouverte, montrant les sections webhook et snapshot]

​
3.7 Exporter les données

Depuis la page Transactions, cliquez sur le bouton Exporter (en haut à droite) pour télécharger les données.

​
4. Processus d’Achat (Côté Acheteur)

Cette section s’adresse à tous les utilisateurs connectés souhaitant acheter une publication sur Oya Editions.

​
4.1 Trouver une publication

  1. Rendez-vous sur la page Publications du site Oya Editions (https://hub.editions.oya.africa/publications).
  2. Naviguez par onglets : Livres, Articles, Documents.
  3. Cliquez sur la couverture ou le titre d’une publication pour accéder à sa page de détail.
  4. Sur la page de détail, vous trouverez les informations sur l’ouvrage (titre, auteur, description, prix).
  5. Cliquez sur le bouton Acheter ou Commander pour accéder à la page de paiement.
[CAPTURE D’ÉCRAN: Page détail d’une publication avec le bouton d’achat visible]

​
4.2 Page de Checkout (Formulaire de commande)

Vous arrivez sur la page https://hub.editions.oya.africa/checkout avec dans l’URL les paramètres publicationId, publicationTitle et publicationType. La page se compose d’un formulaire à gauche et d’un résumé de commande à droite. [CAPTURE D’ÉCRAN: Page de checkout avec le formulaire à gauche et le résumé de commande à droite]

​
Étape 1 — Choisir le type d’achat

Sélectionnez le format souhaité dans le menu déroulant Type d’achat :
  • Version numérique : accès immédiat en ligne après paiement. Vous pourrez lire l’ouvrage depuis votre compte à tout moment.
  • Version physique : livraison à domicile. Votre commande sera traitée sous 24 à 48h après paiement.
[CAPTURE D’ÉCRAN: Sélecteur de type d’achat (numérique / physique)]

​
Étape 2 — Renseigner vos informations personnelles

Remplissez les champs obligatoires (marqués d’un *) :
  1. Prénoms et Nom : votre identité complète (ex: Jean Kouassi)
  2. Courriel : votre adresse e-mail (un e-mail de confirmation sera envoyé à cette adresse)
  3. Téléphone : votre numéro de téléphone au format international (ex: +225 07 12 34 56 78) — ce numéro sera utilisé pour le paiement Mobile Money
  4. Pays d’achat / Pays de livraison : sélectionnez votre pays dans la liste déroulante
Si vous êtes déjà connecté, le nom et l’e-mail sont pré-remplis depuis votre profil.
Pour l’achat physique, seuls les pays où l’ouvrage est disponible en stock physique apparaissent dans la liste des pays.
[CAPTURE D’ÉCRAN: Formulaire d’informations personnelles avec les champs nom, e-mail, téléphone et pays]

​
Étape 3 — Informations de livraison (achat physique uniquement)

Si vous avez sélectionné Version physique, une section supplémentaire s’affiche :
  • Adresse de livraison : renseignez votre adresse complète
  • Stock disponible : la quantité disponible dans votre pays est indiquée

​
Étape 4 — Résumé de commande

Le panneau à droite affiche en temps réel :
  • Le titre de la publication et le format choisi
  • Le prix unitaire (en FCFA)
  • La quantité (toujours 1 exemplaire)
  • Les frais de livraison (inclus pour le physique) ou la mention TVA incluse (pour le numérique)
  • Le Total
  • Les avantages inclus (accès illimité et lecture en ligne pour le numérique ; livraison à domicile, suivi de commande et support client pour le physique)
Si la publication est gratuite, le bouton affiche Obtenir gratuitement et aucun paiement n’est requis.
[CAPTURE D’ÉCRAN: Résumé de commande avec le prix, la quantité et le total]

​
Étape 5 — Valider et procéder au paiement

  1. Vérifiez vos informations et le résumé de commande.
  2. Cliquez sur le bouton Procéder au paiement.
  3. Un message de confirmation s’affiche : “Redirection vers la page de paiement…”
  4. Vous êtes automatiquement redirigé vers l’interface de paiement CinetPay.
Pour annuler avant de payer, cliquez sur Annuler afin de revenir à la page précédente. [CAPTURE D’ÉCRAN: Boutons “Annuler” et “Procéder au paiement” en bas du formulaire]

​
4.3 Paiement via CinetPay (Mobile Money)

CinetPay est la passerelle de paiement utilisée par Oya Editions. Elle permet de payer via Mobile Money (Orange Money, MTN MoMo, Wave, Moov Money, etc. selon le pays).

​
Étapes du paiement mobile sur CinetPay

  1. Sur l’interface CinetPay, sélectionnez votre opérateur de Mobile Money.
  2. Entrez votre numéro de téléphone Mobile Money (le même que celui renseigné dans le formulaire de checkout, ou un autre numéro).
  3. Confirmez le montant affiché.
  4. Validez la transaction :
    • Sur Orange Money / MTN MoMo : composez le code USSD envoyé par SMS, ou confirmez dans l’application.
    • Sur Wave : confirmez dans l’application Wave.
  5. Une fois la validation effectuée sur votre téléphone, ne fermez pas la fenêtre — la plateforme attend la confirmation automatique.
Important : Le numéro de téléphone renseigné dans le formulaire de checkout (Étape 2) est transmis à CinetPay pour faciliter le pré-remplissage. Assurez-vous qu’il correspond au numéro associé à votre compte Mobile Money.
[CAPTURE D’ÉCRAN: Interface CinetPay avec le sélecteur d’opérateur et le champ numéro de téléphone]

​
4.4 Page de Vérification du Paiement

Après avoir validé sur l’interface CinetPay, vous êtes redirigé vers https://hub.editions.oya.africa/checkout/verify. Cette page intermédiaire effectue des vérifications toutes les 3 secondes auprès de l’API Oya Editions, jusqu’à confirmation du webhook CinetPay (maximum 20 tentatives = 60 secondes). Vous verrez :
  • Un indicateur de progression animé
  • Le texte “Vérification du paiement en cours…”
  • Le compteur de tentatives
  • Une barre de progression
Ne fermez pas cette fenêtre pendant la vérification. Le paiement pourrait être confirmé sans que vous soyez redirigé.
[CAPTURE D’ÉCRAN: Page de vérification en cours avec l’animation de chargement et la barre de progression]

​
4.5 Page de Confirmation (Paiement réussi)

Si le paiement est confirmé, vous êtes redirigé vers https://hub.editions.oya.africa/checkout/success avec le résumé de votre commande. Contenu affiché :
  • Bandeau vert : “Paiement réussi !”
  • Message de confirmation : “Merci pour votre achat ! Un courriel de confirmation a été envoyé à votre adresse e-mail. Vous pouvez maintenant accéder à votre ouvrage.”
  • Récapitulatif de commande : titre de l’ouvrage, quantité, montant, ID de transaction, statut
Actions disponibles :
  1. Accéder à l’ouvrage : bouton principal qui vous emmène directement à la page de lecture de la publication.
  2. Voir mes commandes : accède à https://hub.editions.oya.africa/orders pour voir l’historique de vos achats.
  3. Retour aux publications : revenir à la liste des publications.
[CAPTURE D’ÉCRAN: Page de succès avec le bandeau vert, le récapitulatif de commande et les boutons d’action]

​
4.6 En Cas d’Annulation ou d’Échec de Paiement

Si vous annulez le paiement sur CinetPay, ou si le paiement échoue, vous êtes redirigé vers https://hub.editions.oya.africa/checkout/cancel. Contenu affiché :
  • Bandeau rouge : “Paiement annulé”
  • Message d’information : “Aucun montant n’a été débité de votre compte. Vous pouvez réessayer quand vous le souhaitez.”
  • L’ID de la transaction (si disponible)
Raisons possibles d’annulation ou d’échec :
  • Vous avez manuellement annulé la transaction sur l’interface CinetPay
  • Fonds insuffisants sur votre compte Mobile Money
  • Problème de connexion réseau durant la validation
  • Informations de paiement incorrectes (numéro de téléphone erroné, etc.)
  • Délai d’attente dépassé (plus de 60 secondes sans confirmation)
Actions disponibles :
  1. Réessayer le paiement : retourne au formulaire de checkout pour relancer le processus.
  2. Retour aux publications : revenir à la liste des publications.
  3. Contacter le support : accède à la page de contact support (https://hub.editions.oya.africa/support/contact) pour signaler un problème.
Aucun montant n’est jamais débité en cas d’annulation ou d’échec. Si vous constatez un prélèvement non justifié, contactez immédiatement le support.
[CAPTURE D’ÉCRAN: Page d’annulation avec le bandeau rouge, les raisons possibles listées et les boutons d’action]

​
4.7 Paiement en cours de traitement (cas intermédiaire)

Dans certains cas (confirmation webhook différée), la page de succès peut afficher le statut “Paiement en cours de traitement” plutôt que confirmé.
  • Bandeau jaune : “Paiement en cours de traitement”
  • Message : “Votre paiement est en cours de vérification. Vous recevrez un courriel de confirmation dès que le paiement sera validé.”
Dans ce cas, patienter quelques minutes et consulter votre boîte mail. Vous pouvez également vérifier dans Mes commandes (https://hub.editions.oya.africa/orders) si votre commande est bien enregistrée.

​
Récapitulatif des URL