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.
Menus
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.
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.
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.
- 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.
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.
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.
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_…ouPKSANDBOX_…, envoyée dans l'en-têteAuthorization: Bearer) est affichée et se copie d'un clic ; elle peut figurer dans votre code. - La clé secrète (
SKLIVE_…ouSKSANDBOX_…, 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.
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.pingou 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_idde l'API v2,X-Transaction-Iden 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.
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.
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.
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 (
CSsuivi de dix chiffres en Live,TSen 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.