Questions fréquentes

Pas en Live : les clés Live renvoient account_not_activated tant que le dossier n'est pas validé. Oui en mode test avec les clés Sandbox. Activation.

L'e-mail de refus indique la raison. Corrigez le dossier depuis Activer mon compte, en bas du menu du portail, puis cliquez sur Resoumettre le dossier. Après l'envoi.

Oui : créez un service par activité, chacun avec ses clés, ses webhooks, ses terminaux et ses comptes de retrait. Services multiples.

MTN Mobile Money (mtn-benin) et Moov Money (moov-benin). Moyens de paiement.

Envoyez "provider": "auto" : CashChap reconnaît l'opérateur d'après le numéro. Si le numéro ne correspond à aucun opérateur, ou à plusieurs, la demande est refusée (provider_required) : vérifiez le numéro ou indiquez l'opérateur. Choix automatique.

Parce que les frais sont à sa charge (1,7 % soit 17 F) et que le total est arrondi au multiple de 5 F supérieur. Si vous payez les frais, il paie 1 000 F. Prenez toujours le total calculé par CashChap (amount_charged). Arrondi au 5 F.

Scannez le QR code du reçu ou de la facture : il ouvre une page sur cashchap.com qui affiche « Paiement authentique » pour un paiement réel, « Paiement de test » pour un paiement Sandbox (sans valeur) ou « Reçu introuvable » pour un reçu modifié ou inventé. Comparez ensuite le montant, la date et le n° de reçu. Voir Contrôler un reçu.

Le statut reflète la réponse de l'opérateur. pending : le client n'a pas encore validé, attendez. failed ou expired : la raison est dans failure.message. Ne livrez que sur succeeded. Cycle de vie.

Parce qu'à cet instant le client n'a pas encore validé sur son téléphone. La réponse confirme la création de la transaction ; le résultat vient de la lecture de la transaction ou du webhook. Lire une transaction.

amount est un nombre JSON (sans guillemets), sans décimales en XOF, avec au plus les décimales de la devise choisie. Devises.

Le numéro est bloqué par CashChap à la suite d'une fraude avérée : encaissement et retrait vers ce numéro sont refusés. Si vous pensez qu'il s'agit d'une erreur, contactez le support avec la référence de la transaction.

Trop de demandes de paiement ont été envoyées vers ce numéro en peu de temps : CashChap protège le client. Attendez quelques minutes avant de réessayer, sans relancer en boucle. Limites de fréquence.

Dans Compte › Préférences, bloc Frais d'opération, opérateur par opérateur : case décochée (« Frais supportés par le client »), le client paie les frais ; case cochée, vous les prenez à votre charge. Qui paie les frais.

Oui : la v1 est retirée depuis le 11 octobre 2026 (toute adresse /v1 répond 410). La v2 garde la même logique de paiement avec une seule clé par appel, des réponses régulières et des messages en français. Guide de migration.

Ouvrez la console du navigateur : le SDK y écrit l'option manquante ou invalide (clé, montant, devise, adresse de retour). Erreurs d'intégration.

Non. La clé secrète donne accès aux retraits et aux données complètes des clients : elle reste sur votre serveur. L'application appelle votre serveur, qui appelle CashChap ; pour un terminal de paiement, utilisez une clé de terminal. Authentification.

Si les deux portaient la même Idempotency-Key, une seule transaction existe : la seconde réponse est la copie de la première (Idempotent-Replayed: true). Envoyez aussi une reference unique par commande : un second paiement de la même commande est refusé (duplicate_reference). Idempotence.

Elle est masquée : cliquez sur Afficher et saisissez votre propre mot de passe (cinq essais par quart d'heure). Elle s'affiche une fois et chaque affichage est inscrit au journal d'activité. Clés API.

Vérifiez que le webhook est actif dans le bon environnement (Live ou Sandbox), que l'adresse est en HTTPS avec un certificat valide, sans redirection, et répond 2xx en moins de dix secondes. L'historique des livraisons de Développeurs › Webhooks donne le statut, la tentative, le code HTTP de votre réponse et la dernière erreur, avec un bouton Relancer. Livraison et relances.

C'est attendu : si votre serveur a répondu trop tard ou hors 2xx, CashChap relance le même envoi. Dédoublonnez avec l'en-tête X-CashChap-Delivery. Bonnes pratiques.

En mode Sandbox, le numéro choisit le scénario : 2290166000000 réussit, 2290166000012 simule un solde insuffisant, 2290166000001 une attente de 45 secondes. Scénarios.

Le numéro a été envoyé au format national. Ajoutez l'indicatif du pays, sans « + » : 2290166000000 au lieu de 0166000000 pour le Bénin. Numéros de téléphone.

Dans la spécification OpenAPI 3.1 (https://cashchap.com/docs/openapi/v2.yaml), à importer dans Postman, Insomnia ou un générateur de client.

En général dès la réussite du paiement. CashChap peut différer la mise à disposition ou la soumettre à validation pour un compte ou un service, et geler les fonds d'un paiement en vérification. Chaque encaissement indique available. Mise à disposition des fonds.

Ouvrez le détail du paiement dans Paiements : il indique si les fonds sont en cours de mise à disposition (avec la date prévue) ou en vérification. Le paiement reste réussi et rien n'est remboursé. Si la situation dure, écrivez au support avec la référence de la transaction. Vérifications.

Le numéro doit être un compte autorisé actif du service, le montant entre 10 000 XOF et 5 000 000 XOF et inférieur au disponible. Retraits Mobile Money.

Le contrôle antifraude l'a retenu : le montant est réservé mais rien n'est envoyé tant que CashChap n'a pas décidé. Validé, il part ; refusé, le montant revient sur votre solde. Vous êtes prévenu par e-mail. Retrait en vérification.

Il est traité manuellement par l'équipe CashChap aux heures ouvrées, après contrôle ; vous êtes prévenu par e-mail et par le webhook withdrawal.success. Vous pouvez l'annuler tant qu'il n'est pas pris en charge. Virements.

Remboursement total du prix (hors frais), dans les 30 jours, débité de votre solde et validé par CashChap. Depuis le détail du paiement, bouton Rembourser. Remboursements.