Remboursements
Un remboursement rend au payeur le montant d'un paiement Mobile Money réussi, sur le numéro qui a payé, par l'opérateur d'origine. Il est débité de votre solde disponible et validé par l'équipe CashChap avant tout versement.
Les règles
- Remboursement total seulement : un seul remboursement par paiement, pour la totalité du prix. Pas de remboursement partiel.
- Hors frais : le payeur récupère le prix (
amountde la transaction), pas les frais ni l'arrondi qu'il a éventuellement payés. Les frais de CashChap ne sont pas rendus. - Débité de votre solde : le montant est réservé sur votre solde disponible dès la demande ; si le solde ne suffit pas, la demande est refusée avec le montant manquant.
- 30 jours au plus après la date du paiement.
- Mobile Money MTN ou Moov Bénin, pour un paiement demandé dans la devise de l'opérateur (XOF). Les autres cas se traitent avec le support.
- Fonds disponibles : un paiement dont les fonds sont gelés, en vérification ou pas encore mis à disposition ne peut pas être remboursé depuis votre solde tant qu'ils ne sont pas disponibles (voir vérifications).
- Validation par CashChap : chaque demande est examinée, puis validée par un second agent de CashChap (double contrôle) avant le versement. Aucun versement ne part sans validation.
- Qui peut demander : le titulaire du service ou un collaborateur administrateur, avec son mot de passe.
Demander un remboursement
- Ouvrez le paiement dans Paiements › Paiements client (ou Paiements marchand) du portail, en mode Live, puis son Détail.
- Cliquez sur Rembourser, en haut du détail : le bloc Remboursement affiche le montant rendu au payeur, votre solde disponible, et la raison si le paiement n'est pas remboursable.
- Indiquez le motif (facultatif), votre mot de passe, cochez la confirmation du débit et cliquez sur Demander le remboursement. La demande est « en attente d'examen » : vous pouvez encore l'annuler tant qu'elle n'a pas été traitée.
- Suivez-la dans Argent › Remboursements et dans le bloc « Remboursement » du détail du paiement. Vous êtes prévenu par e-mail et par notification à chaque étape.
Il n'existe pas encore de route de remboursement dans l'API v2 : POST /v2/refunds et GET /v2/refunds/{id} répondent 501 not_implemented. Utilisez le portail.
États d'un remboursement
| État | Signification | Webhook |
|---|---|---|
| En attente | Demande enregistrée, montant réservé sur votre solde, en attente de validation par CashChap. | refund.pending |
| Effectué | Le payeur a reçu le montant ; le paiement d'origine indique le montant remboursé (refunded_amount). | refund.success |
| Refusé | CashChap a refusé la demande ; le montant réservé revient sur votre solde. | refund.rejected |
| Échoué | L'opérateur n'a pas pu verser ; le montant réservé revient sur votre solde. | refund.failed |
| Annulé | Demande annulée avant sa validation ; le montant réservé revient sur votre solde. | refund.cancelled |
Les webhooks refund.* arrivent comme les autres événements (Webhooks). Leurs données donnent l'identifiant du remboursement (transactionId), celui du paiement remboursé (paymentId), le montant, la devise, le statut, la raison, l'origine de la demande et le mode.
Paiements en double
Si un même numéro paie deux fois le même montant au même service en moins de 30 secondes, sans référence de commande distincte, CashChap peut proposer lui-même le remboursement du second paiement (le premier est conservé). Envoyer une reference unique par commande évite cette confusion. La proposition suit le même circuit (réservation sur votre solde, validation par CashChap, webhooks, e-mails) ; elle ne s'annule pas depuis le portail : contactez le support si le second paiement était voulu.
En mode Sandbox
Les remboursements de test sont simulés, sans opérateur ni argent réel, et validés automatiquement : vous pouvez tester la réception des webhooks refund.*.