Aller au contenu
CashChap CashChap Docs

Tableau de bord du portail

Le portail marchand (cashchap.com) centralise vos soldes, vos paiements, vos retraits et vos outils d'intégration. Voici ses menus, service par service.

Le menu latéral regroupe les pages en six entrées : Tableau de bord, Paiements, Argent, Clients, Développeurs et Compte. Les sections de plusieurs pages (Paiements, Argent, Développeurs, Compte) se déplient d'un clic, comme un accordéon, et celle de la page ouverte se déplie d'elle-même. En bas du menu : Activer mon compte tant que votre dossier n'est pas validé (« Activation en cours » pendant la vérification), puis Déconnexion. Un collaborateur invité ne voit que les pages permises par son rôle.

En haut du menu, le sélecteur de service change de service et l'étiquette Live ou Sandbox rappelle l'environnement affiché. En haut à droite, le bouton Sandbox / Live bascule d'un environnement à l'autre, à côté des notifications et de votre profil. Le menu du profil donne accès à Mon profil, au mot de passe, à vos préférences et à Changer de thème, qui fait passer le portail en mode sombre ou clair après confirmation. Le fil d'Ariane, en haut de chaque page, rappelle où vous êtes (par exemple « CashChap › Paiements › CashChap Link › Créer un lien ») ; « CashChap » ramène au tableau de bord. Toutes les dates et heures sont affichées dans le fuseau horaire de votre compte.

Menu latéral du portail : logo CashChap, sélecteur du service Boutique en ligne, étiquette LIVE, puis les sections Tableau de bord, Paiements dépliée (Paiements marchand, Paiements client, CashChap Link, Ma boutique, QR code de la boutique), Argent, Clients, Développeurs, Compte et Déconnexion.
Le menu en accordéon, section Paiements dépliée.

Accueil

Le tableau de bord présente, pour le service et l'environnement sélectionnés :

  • Relevé de compte : solde général (cumul des encaissements validés), solde en cours (encaissements validés dont les fonds ne sont pas encore disponibles ou sont retenus pour vérification), solde disponible (retirable maintenant) et total des retraits.
  • Historique des transactions : courbe des entrées et des sorties mois par mois, avec le total du mois en cours et celui du mois passé, filtrable par catégorie et par période.
  • Moyens de paiement : répartition des encaissements par moyen de paiement (Mobile Money, carte…).
  • Transactions récentes et Activités récentes, chacune avec un lien Voir plus ; les dates s'affichent en français, dans le fuseau de votre compte (« 11 oct. 2026, 14:55 »).
  • Pour un service réglé dans une autre devise que le XOF (l'euro, par exemple), soldes, totaux et transactions récentes sont dans cette devise seulement, sans aucun montant en XOF (« 949,00 EUR », « 0,30 EUR ») ; le XOF reste affiché dans le détail des opérations, les listes et les exports : voir Ce que vous voyez dans le portail.
  • Outils rapides : faire un retrait (Live uniquement), ajouter un compte de retrait, créer un lien de paiement, ajouter un collaborateur, clés API et webhooks.
Tableau de bord du portail en mode Live pour le service Boutique en ligne : menu latéral, bascule Sandbox / Live, cloche avec 2 notifications et initiales AD de la titulaire en haut à droite, relevé de compte (solde général 622 500 XOF, solde en cours 0 XOF, solde disponible 249 500 XOF, total des retraits 343 000 XOF), historique des transactions en courbe avec les mois en français, camembert des moyens de paiement, transactions récentes (Koffi Agbodjan 32 000 XOF le 11 oct. 2026 à 08:33, Sènami Houngbédji 12 500 XOF et 5 000 XOF le 10 oct., Jean-Baptiste Akpovi 45 000 XOF le 8 oct.), activités récentes (Connexion le 11 oct. 2026 à 14:55, Changement de mode, Webhook, Lien de paiement « Panier découverte ») et Outils rapides.
Le tableau de bord, en mode Live : la page entière, telle qu'elle s'affiche dans une fenêtre de 1920 pixels.

Paiements

Les listes de paiements s'affichent de la plus récente à la plus ancienne, avec des filtres (recherche par nom, téléphone ou référence, statut, réseau, période, montant saisi dans la devise du service), un tri par date, montant, client ou statut, les chiffres de la sélection et un export CSV de la sélection filtrée (au plus 5 000 lignes, les plus récentes d'abord). Chaque ligne donne la date, le client, le réseau, le montant, les frais et le statut ; la page de détail d'un paiement regroupe les montants (prix, payé par le client, frais payés par le client, commission CashChap, net crédité et, pour un service dans une autre devise que le XOF, le taux de conversion ; chaque montant dans la devise du service puis en XOF), le client, le statut avec le code de réponse éventuel, toutes les références (référence CashChap, référence de paiement reprise dans les webhooks, votre external_id, référence de l'opérateur, numéro de facture) et la facture PDF. Pour un paiement validé, le net crédité est suivi de « dans le solde disponible » ou « en cours de reversement » ; si CashChap retient les fonds le temps d'une vérification, une ligne Mise à disposition indique « Fonds en attente de mise à disposition (vérification CashChap) ». Voir Mise à disposition des fonds.

Page Paiements › Paiements client en mode Live, sous-titre « Paiements faits par vos clients (CashChap Link, widget) », filtrée sur les 7 derniers jours : chiffres de la sélection (7 paiements, 99 000 XOF encaissés nets, taux de succès 83,3 %, 1 en attente), bouton Exporter (CSV), filtres Rechercher, Statut, Réseau, Période et Montant (XOF), rappel du filtre appliqué, puis la liste complète du 6 au 11 octobre avec la date, le client et son numéro masqué (+229 ••• 0011…), le réseau (MTN ou Moov, Mobile Money), le montant, le net et le statut de chaque paiement (validé, en attente ou échoué pour solde insuffisant), et le pied de liste « 1–7 sur 7 paiements ».
Paiements › Paiements client, filtrée sur les 7 derniers jours : chiffres, filtres et liste.
Détail d'un paiement client validé de Koffi Agbodjan, 32 000 XOF, le 11 oct. 2026 à 08:33 (fil d'Ariane CashChap › Paiements › Paiements client › Détail, entrée Paiements client active dans le menu) : boutons Télécharger la facture et Rembourser, blocs Statut et dates, Montants (Prix 32 000 XOF, Payé par le client 32 545 XOF, Frais payés par le client 545 XOF, Commission CashChap 545 XOF, Net crédité 32 000 XOF dans le solde disponible, frais à la charge du client), Client et réseau (MTN, Mobile Money, canal « Paiement client (CashChap Link, widget) »), Identifiants pour le support (référence de l'opérateur 4814123766, facture), puis le bloc Remboursement.
Le détail d'un paiement : montants, références (dont celle de l'opérateur), facture et bouton Rembourser.
  • Paiements marchand : encaissements que vous avez lancés vous-même depuis la boutique ou l'API en tant que marchand.
  • Paiements client : paiements initiés par vos clients (SDK, widget, API, liens de paiement). Un paiement Mobile Money validé peut être remboursé (voir Remboursements).
  • CashChap Link (encaissement à distance) : création, aperçu, partage et suivi de vos liens de paiement. Détail dans CashChap Link.
  • Ma boutique : encaissement d'un client présent, sans site web, par son numéro ou par un QR code à usage unique (voir ci-dessous).
  • QR code de la boutique : le QR code permanent de votre comptoir, à imprimer ; le client le scanne, saisit le montant et paie. Détail dans QR codes.

Argent

  • Retrait : comptes autorisés (numéros Mobile Money et comptes bancaires), retrait instantané, retraits programmés par période ou par palier. Détail dans Fonds et retraits.
  • Reversements : retraits Mobile Money et virements bancaires effectués, avec leur statut.
  • Remboursements : historique des remboursements effectués.
  • Dépôts : crédits effectués par l'équipe CashChap sur votre solde.
  • Ajustements : corrections de solde opérées par CashChap, toujours motivées.

Ces listes offrent les mêmes filtres, le même export CSV et une page de détail par opération.

Page Argent › Reversements en Live : chiffres (6 reversements, 343 000 XOF reversés, 30 000 XOF en attente, 1 échoué), filtres Rechercher, Statut, Type, Versement, Période et Montant, puis la liste des six retraits Mobile Money avec le bénéficiaire (Aïcha Dossou +229 ••• 0001 ou Boutique Démo +229 ••• 0007), le type, le montant et le statut.
Argent › Reversements.

Clients

Liste des clients ayant payé sur vos canaux (nombre de paiements, total encaissé, dernier paiement), avec pour chacun les boutons Paiements et Fiche, des filtres et l'export CSV. Un numéro bloqué par CashChap (fraude avérée) ne peut plus payer ni recevoir de retrait : l'API répond phone_number_blocked. Si un client légitime est concerné, contactez le support.

Page Clients en Live, sous-titre « Personnes qui ont payé par CashChap Link ou par le widget, avec leur activité » : chiffres (12 clients, 12 actifs, 34 paiements, 560 500 XOF encaissés), filtres Rechercher et Période, puis la liste des 12 clients triée par dernier paiement (Rachida Bello et Koffi Agbodjan le 11 oct., Sènami Houngbédji le 10 oct.…) avec le contact (numéro masqué et e-mail), le nombre de paiements, le total encaissé, le dernier paiement et les boutons Paiements et Fiche, et le pied de liste « 1–12 sur 12 clients ».
Clients : vos payeurs et leur activité.

Ma boutique

Pour encaisser un client présent, sans site web, ouvrez Paiements › Ma boutique (page « Web Caisse ») : tapez le numéro national du client à côté de l'indicatif du moyen choisi (+229), qui est envoyé avec lui au format international sans « + » (2290166000012) ; le portail reconnaît l'opérateur d'après le numéro (Mobile Money par défaut). Indiquez le montant : il s'affiche aussi sur l'écran de la calculatrice de droite, qui aide à le composer (→ Montant le reporte dans le champ). Cliquez enfin sur Encaisser. Montant et récapitulatif sont dans la devise du service (« Montant (XOF) », « Montant (EUR) ») : montant, frais, total payé par le client (frais et arrondi au 5 F compris) et ce que vous recevez. Le client reçoit la demande de validation sur son téléphone ; une fois le paiement reçu, vous pouvez lui transmettre le reçu. La boutique fonctionne comme une caisse de l'API v2 (canal shop, voir Terminaux de paiement) ; ses encaissements apparaissent dans Paiements marchand, avec le nom du collaborateur qui a encaissé.

Sans le numéro du client, cliquez sur Afficher un QR : seul le montant est nécessaire. Un QR code à usage unique, valable 5 minutes, s'affiche avec le total que paiera le client ; il le scanne, paie lui-même, et la caisse affiche « Paiement reçu » dès que le paiement est confirmé. Détail dans QR code à la caisse.

Page Web Caisse (Paiements › Ma boutique) en Live, caisse « Boutique du portail · Aïcha Dossou » : moyen de paiement Mobile Money, opérateur MTN MOBILE MONEY (BJ) reconnu automatiquement d'après le numéro de Sènami Houngbédji, tapé 01 66 00 00 12 à côté de l'indicatif +229, montant 12 500 XOF repris sur l'écran de la calculatrice, récapitulatif avec 215 XOF de frais payés par le client, 12 715 XOF de total payé par le client et 12 500 XOF reçus, boutons Encaisser et Afficher un QR, puis la consigne du bouton Afficher un QR (seul le montant est nécessaire, le client scanne le QR et paie lui-même, le QR ne sert qu'une fois et expire au bout de quelques minutes).
Ma boutique : encaisser un client présent par son numéro, ou lui présenter un QR code avec « Afficher un QR ».
Page Web Caisse en Live d'un service réglé en euros : opérateur MTN MOBILE MONEY (BJ) reconnu d'après le numéro 01 66 00 00 12, champ Montant (EUR) à 12,50 repris sur la calculatrice, récapitulatif Montant 12,50 EUR, Frais (payés par le client) 0,34 EUR (dont 0,13 EUR de frais de change), Total payé par le client 12,84 EUR, Vous recevez 12,50 EUR, boutons Encaisser et Afficher un QR.
La même caisse sur un service en euros : 12,50 EUR, 12,84 EUR payés par le client.

Développeurs

Les pages de ce menu portent sur l'environnement affiché dans la barre du haut (Live ou Sandbox) : basculez d'environnement pour voir les clés, le webhook et les journaux de l'autre.

Clés API

  • Une paire de clés par environnement : la clé publique (PKLIVE_… ou PKSANDBOX_…, envoyée dans l'en-tête Authorization: Bearer) est affichée et se copie d'un clic ; elle peut figurer dans votre code.
  • La clé secrète (SKLIVE_… ou SKSANDBOX_…, envoyée de la même façon, depuis votre serveur uniquement) n'est jamais écrite dans la page. Pour l'afficher, saisissez votre propre mot de passe (celui du collaborateur pour une session invitée) : la clé apparaît une seule fois, sans être conservée par le navigateur, et chaque affichage est inscrit dans le journal d'activité. Cinq mots de passe erronés par quart d'heure bloquent temporairement l'affichage.
  • Le titulaire, un administrateur ou un développeur peuvent afficher la clé secrète ; un collaborateur d'un autre rôle ne voit que la clé publique.
  • Régénérer les clés est réservé au titulaire et aux administrateurs : mot de passe, puis saisie du mot REGENERER. Une nouvelle paire remplace l'actuelle immédiatement : toutes les intégrations qui utilisent les anciennes clés (site, application, serveur) cessent de fonctionner jusqu'à leur mise à jour. À faire si une clé a pu être exposée, en coordination avec votre équipe technique.
Page Développeurs › Clés API en Live : avertissement Vous êtes en Live, clé publique PKLIVE_DEMO factice avec le bouton Copier, clé secrète masquée SKLIVE_ avec le champ mot de passe et le bouton Afficher, bloc Régénérer les clés Live (mot de passe, saisie de REGENERER), puis le bloc Bien utiliser vos clés.
Développeurs › Clés API (clés factices de démonstration).

Webhooks

  • Plusieurs webhooks par service et par mode (Live ou Sandbox), dans une limite affichée en haut de page (5 par défaut). Chaque carte donne le nom, l'adresse (https:// obligatoire), l'état, les types d'événements reçus (« Tous les événements » ou la liste choisie) et la fin du secret. Ajouter un webhook et Modifier ouvrent le formulaire : adresse, nom, cases par groupe d'événements, état ; mot de passe à chaque enregistrement et inscription au journal d'activité. Seuls le titulaire, les administrateurs et les développeurs agissent.
  • Le secret de signature s'affiche une seule fois, à l'ajout du webhook ; Nouveau secret (formulaire Modifier, mot de passe) le remplace et l'affiche une fois. Détail dans Webhooks.
  • Tester : CashChap met en file, vers ce webhook, un test.ping ou un exemple du type choisi (transaction fictive, test à true), chiffré et signé comme un vrai événement ; votre serveur doit l'ignorer. Au plus 5 événements de test par heure et par service dans chaque mode.
  • Historique des livraisons : chaque événement envoyé en Live ou en Sandbox, filtrable par statut (Livrée, En attente, Échouée, Abandonnée), par webhook ou par référence de transaction, avec sa tentative (n sur 6), le code HTTP de votre réponse et un détail : prochain essai, durée, dernière erreur, extrait de votre réponse (500 caractères au plus), données envoyées (secrets et numéros masqués). Une livraison échouée ou abandonnée, ou en attente depuis plus de dix minutes, se relance manuellement, au plus 10 fois par heure et par livraison. Détail dans Webhooks.

Journaux API

  • Les appels reçus par l'API avec vos clés (demande de prélèvement, demande de retrait) et le résultat final de chaque transaction, pour l'environnement affiché : point d'entrée, méthode et chemin public (par exemple POST /v2/collections, dans la liste, le détail et l'export), résultat (acceptée, refusée, validée, échouée) avec le code d'erreur éventuel, code HTTP, durée, adresse IP, identifiant de requête (request_id de l'API v2, X-Transaction-Id en v1).
  • Filtres par point d'entrée, résultat, code HTTP (2xx, 4xx, 5xx) et période ; recherche par description, référence de transaction ou identifiant ; export CSV.
  • Le détail d'un appel montre la requête reçue et la réponse rendue : clés, secrets, jetons, mots de passe et numéros de téléphone y sont masqués, et le contenu est tronqué au-delà de 4 000 caractères.
  • Les appels enregistrés avant le 10 octobre 2026, et les résultats finals écrits par le système, n'ont ni méthode, ni code HTTP, ni durée, ni adresse IP.
Page Développeurs › Journaux API en Live, filtrée du 08/10/2026 au 11/10/2026 : chiffres de la sélection (10 appels, 5 demandes acceptées, 1 refusée, 1 transaction échouée), filtres Rechercher, Point d'entrée, Résultat, Code HTTP et Période, puis la liste complète avec la date, l'appel (Prélèvement (demande), POST /v2/collections, ou Prélèvement (résultat)), le résultat (Refusée avec invalid_phone_number, Acceptée, Validée, Échouée), le code HTTP, la durée, l'adresse IP de documentation 203.0.113.x et l'identifiant, et le pied de liste « 1–10 sur 10 appels ».
Développeurs › Journaux API, filtrés du 8 au 11 octobre.

Terminaux de paiement

  • Réservée au titulaire et aux administrateurs : création d'un terminal de paiement (TPE) après votre mot de passe, avec un code d'activation affiché une seule fois, valable 15 minutes.
  • Liste des terminaux de l'environnement affiché : statut (en attente d'activation, actif, révoqué), validation par CashChap pour son tarif, appareil, dernière activité ; Révoquer coupe immédiatement le terminal. Le bloc Créer un terminal (nom, point de vente, votre mot de passe) en ajoute un.
  • Détail du fonctionnement dans Terminaux de paiement.

Compte

Les pages de cette section s'ouvrent aussi par les onglets placés en haut de chacune : Mon profil, Entreprise, Préférences, Sécurité, Collaborateurs, Journal d'activité.

  • Mon profil : photo (Changer la photo), coordonnées (l'adresse e-mail, identifiant du compte, ne se change pas ici ; un numéro vérifié se change par le support) et Changer le mot de passe.
  • Entreprise : informations du dossier d'activation (KYC) et, pour le service affiché, le nom public et le logo montrés à vos clients sur les pages de paiement, les reçus et les factures.
  • Collaborateurs : invitations, rôles, demandes reçues. Voir Collaborateurs et rôles.
  • Préférences, réglages du service affiché, en blocs : Moyens de paiement (moyens par lesquels vos clients peuvent vous payer), Frais d'opération (moyens dont vous prenez les frais à votre charge ; sinon ils sont payés par le client), Devises des passerelles et du service (devise de chaque passerelle pour les prélèvements et les reversements, devise de préférence du service), Devise et affichage des montants, Notifications (en Live : case Prélèvement validé, e-mail « Paiement reçu » et notification dans le portail quand un client vous paie ; case Retrait validé, notification dans le portail, l'e-mail de confirmation de chaque retrait étant envoyé dans tous les cas) et Fuseau horaire.
  • Sécurité : double authentification, appareils connus, suppression du compte.
  • Journal d'activité : qui a fait quoi (connexion, modification d'un paramètre, retrait, régénération de clé, affichage d'une clé secrète ou d'un secret de webhook…), avec l'adresse IP et l'appareil. Les appels reçus par l'API avec vos clés sont dans Développeurs › Journaux API.
Page Compte, onglet Mon profil (onglets dans l'ordre du menu : Mon profil, Entreprise, Collaborateurs, Préférences, Sécurité, Journal d'activité) : carte d'Aïcha Dossou avec ses initiales AD (e-mail demo@boutique-demo.example, pays Bénin, téléphone +229 01 97 00 00 01, adresse, compte créé le 3 août 2026) et le bouton Changer la photo, puis les blocs Mes coordonnées (téléphone vérifié +229 01 97 00 00 01) et Changer le mot de passe.
Compte › Mon profil.
Page Compte, onglet Préférences, haut de la page : blocs Moyens de paiement (MTN Mobile Money et Moov Money cochés), Frais d'opération (frais supportés par le client) et Devises des passerelles et du service avec l'avertissement « Changer une devise peut entraîner des frais » (frais de change de 1 % hors XOF), la devise des prélèvements et des reversements (XOF) et la Devise de préférence du service (Franc CFA, XOF).
Compte › Préférences : moyens de paiement, frais d'opération et devises des passerelles et du service.

Fuseau horaire

Les dates sont enregistrées en temps universel et affichées dans le fuseau horaire de votre compte, réglable dans Compte › Préférences, bloc Fuseau horaire. Par défaut, c'est celui de la plateforme, Africa/Porto-Novo (UTC+1, heure du Bénin). Le réglage est propre à chaque personne : un collaborateur invité voit les heures dans le fuseau de son propre compte, pas dans celui du marchand qui l'a invité. Les exports CSV reprennent ce fuseau ; les dates renvoyées par l'API ne sont pas concernées.

Devise et affichage des montants

Dans Compte › Préférences, bloc Devise et affichage des montants, le titulaire ou un collaborateur administrateur règle la présentation des montants du portail et des exports :

  • Devise d'affichage : la devise du compte s'applique à tous vos services ; le service affiché peut avoir la sienne (Devise de préférence du service, dans le bloc Devises des passerelles et du service), qui l'emporte alors. Les totaux, soldes et chiffres clés sont toujours exprimés dans la devise affichée, convertis une seule fois depuis la somme en XOF, le montant XOF étant rappelé en petit ; la mention « au taux du jour » n'apparaît que pour une devise à taux variable (l'euro est à parité fixe), avec un avertissement discret si le taux est ancien ou en attente de validation.
  • Une seule règle d'affichage : chaque opération est affichée dans la devise d'affichage au taux de sa date, le montant enregistré en XOF étant rappelé en second ; vos clients voient vos prix, les frais et le total dans la devise du service. Les montants enregistrés ne changent jamais.
  • Délai entre deux changements de devise : CashChap peut imposer un délai minimal (par exemple un changement par mois) ; la page indique la date du prochain changement possible.
  • Format propre à chaque devise : décimales, séparateurs, symbole ou code et sa position suivent les réglages de la devise (le XOF s'affiche sans décimale, code après le nombre). Dans les exports CSV, les colonnes en devise d'origine, en XOF et en devise affichée sont toujours toutes présentes.
Bloc Devise et affichage des montants de la page Préférences, service en euros : devise affichée actuellement EUR (devise du service « Boutique en ligne », qui l'emporte sur celle du compte), Devise du compte (Franc CFA, bouton Enregistrer la devise, aucun délai entre deux changements), puis Affichage des montants : chaque opération affichée en EUR au taux de sa date, totaux et soldes convertis une seule fois depuis la somme en XOF, montant enregistré en XOF rappelé en second, clients qui voient la devise du service sur toute la chaîne de paiement.
Le bloc Devise et affichage des montants de la page Préférences.

Détail des règles de conversion dans Frais et devises.

Reçus et factures

  • Chaque transaction validée produit une facture PDF numérotée (CS suivi de dix chiffres en Live, TS en mode test), téléchargeable depuis le détail du paiement, par le lien de l'e-mail de reçu ou par l'adresse signée de l'écran final ; elle porte le QR code d'authentification du paiement.
  • Le client reçoit un reçu par e-mail lorsque son adresse est connue (paiement par le widget, un lien de paiement ou l'API) ; en boutique, vous l'envoyez d'un clic par WhatsApp, SMS ou e-mail.
  • À la fin d'un paiement par le widget, un CashChap Link ou un QR code, le client peut aussi télécharger son reçu en image ou le partager (WhatsApp…) depuis l'écran final : voir Reçu du client.
  • Chaque reçu et chaque facture portent un QR code d'authentification : scanné, il ouvre la page publique de vérification de CashChap (« Paiement authentique », « Paiement de test » ou « Reçu introuvable »). Voir Reçus et vérification.