Fonds et retraits

Vos encaissements alimentent le solde du service. Vous les retirez vers un numéro Mobile Money (à la demande ou automatiquement) ou vers un compte bancaire, en XOF. Cette page explique aussi quand les fonds deviennent disponibles et ce qui se passe lorsqu'un paiement ou un retrait est vérifié par CashChap.

Les soldes

Dans l'API v2, chaque encaissement indique si ses fonds sont disponibles (available) et le montant crédité (net_amount). Le solde disponible est recalculé à chaque demande de retrait ; un retrait supérieur au disponible est refusé (insufficient_balance).

Mise à disposition des fonds

Par défaut, un encaissement réussi entre immédiatement dans le solde disponible. CashChap peut appliquer une autre règle à la plateforme, à un opérateur, à votre compte ou à un service, en mode Live seulement :

• Le paiement reste réussi (statut succeeded, webhook envoyé, facture émise) ; seule la disponibilité de ses fonds est décalée.
• Le détail du paiement, dans le portail, indique la règle appliquée et la date prévue de mise à disposition ; vous êtes prévenu par e-mail quand des fonds attendent ou deviennent disponibles.
• En mode Sandbox, les fonds de test sont toujours disponibles tout de suite.

Encaissements à confirmer

Les paiements reçus par certains opérateurs (Mobile Money hors du Bénin, par exemple au Cameroun, BAXI, cartes bancaires) ne sont pas versés sur les comptes de reversement de CashChap mais sur son compte bancaire, par l'opérateur ou son intermédiaire. Pour ces paiements, en mode Live :

• le paiement est réussi pour le payeur et pour vous : statut succeeded, reçu, facture et webhook de paiement inchangés ;
• le montant crédité reste dans le solde en cours, avec la mention « en attente de confirmation de l'encaissement », et n'est pas retirable ;
• dès que CashChap a constaté la réception des fonds sur son compte bancaire (relevé ou règlement de l'opérateur), il entre dans votre solde disponible.

Les paiements MTN Mobile Money et Moov Money du Bénin ne sont pas concernés : leurs fonds sont disponibles comme d'habitude. Dans le portail, le tableau de bord et le détail du paiement indiquent le montant en attente. Dans l'API v2, GET /v2/balance donne pending_confirmation et chaque encaissement porte funds.status = pending_confirmation ; les abonnés reçoivent funds.held puis funds.released (funds.reason = collection_confirmation). En mode Sandbox, rien n'est retenu : la mention apparaît avec « simulé » pour vos essais, et le montant est déjà disponible.

Vérifications et gel des fonds

CashChap contrôle chaque encaissement et chaque retrait Live (contrôle antifraude). La plupart passent sans que vous ne voyiez rien. Sinon :

Encaissement en vérification

• Le paiement se déroule normalement (statut succeeded, reçu et webhook inchangés), mais ses fonds sont gelés : ils restent dans le solde « en cours » et ne sont pas retirables. Vous recevez un e-mail « Fonds en cours de vérification ».
• CashChap peut aussi retenir pour un temps les encaissements d'un compte ou d'un service entier (tous, ou seulement ceux réglés par carte). Le détail du paiement indique alors « Fonds en attente de mise à disposition (vérification CashChap) ».
• À l'issue de la vérification, les fonds sont libérés (ils entrent dans le solde disponible, avec un e-mail), ou la collecte est retenue : ses fonds ne sont pas crédités sur votre solde, le détail du paiement indique « Fonds retenus après vérification » et vous recevez un e-mail. Une collecte retenue peut ensuite vous être reversée, être restituée au payeur ou être conservée, selon la décision de CashChap.
• Un gel n'engage aucun remboursement automatique et un paiement dont les fonds sont gelés ne peut pas être remboursé depuis votre solde.

Retrait en vérification

• Le montant est réservé sur votre solde, mais le retrait n'est pas envoyé à l'opérateur : il reste pending (« en cours de vérification ») et vous recevez un e-mail.
• Validé, il part une seule fois vers l'opérateur. Refusé, il passe en échec et le montant revient sur votre solde disponible, avec un e-mail.
• Si le contrôle est momentanément impossible, la demande de retrait est refusée sans rien débiter (payouts_temporarily_unavailable, 503) : réessayez quelques minutes plus tard.

Limites de fréquence

Trop de demandes en peu de temps (vers un même numéro, pour un même marchand, ou trop de retraits pour un service) sont refusées avec 429 (too_many_pending_for_phone ou rate_limited), sans appel à l'opérateur. Attendez quelques minutes avant de réessayer ; ne relancez pas en boucle.

Pour toute question sur des fonds retenus, écrivez au support (support@cashchap.com) avec la référence de la transaction et le nom du service.

Comptes autorisés

Un retrait ne part que vers un compte autorisé du service, listé dans le bloc Comptes de retrait autorisés de la page Argent › Retrait :

1. Nouveau compte : bouton Ajouter un compte (en haut de la page) ou Ajouter un compte de retrait (en bas) ; choisissez le type (Mobile Money avec l'opérateur MTN ou Moov, ou virement bancaire avec la banque : UBA, Ecobank, BOA) et saisissez les coordonnées.
2. Code d'activation : un code vous est envoyé par e-mail, à l'adresse du compte ; saisissez-le pour activer le compte.
3. Gestion : Détail affiche le compte, Supprimer le retire ; un compte bloqué par CashChap ne reçoit plus de retrait.

Par l'API, un numéro qui n'est pas un compte autorisé actif est refusé (recipient_not_authorized).

Délai de sécurité (mode Live) : le premier retrait vers un numéro ou un compte bancaire ajouté il y a moins de 24 h est refusé, avec l'heure à partir de laquelle il sera possible (recipient_cooling_off). De même, un crédit manuel fait par CashChap (ajustement de solde) apparaît tout de suite dans votre solde mais n'est retirable que 24 h après son application (balance_not_yet_withdrawable). Le mode Sandbox n'a pas ces délais.

Retraits Mobile Money

Retrait instantané

Dans le bloc Demander un retrait de la page Argent › Retrait, choisissez le moyen de retrait (Mobile Money), le compte à créditer et le montant : les bornes, le montant débité et le délai s'affichent avant la confirmation. Cliquez sur Retirer puis confirmez. CashChap ordonne le transfert à l'opérateur ; le statut passe de pending à succeeded en quelques secondes, ou à failed avec la raison. Le webhook withdrawal.success ou withdrawal.failed est envoyé.

Si votre service est réglé dans une autre devise que le XOF, les soldes et l'historique des reversements s'affichent d'abord dans cette devise, avec le XOF en second ; le montant du retrait, lui, se saisit toujours en XOF (l'argent réellement versé), et son équivalent dans la devise du service s'affiche en direct, comme les bornes (« Minimum 10 000 XOF (≈ 15,24 EUR) »). Voir Devise du service.

Versement automatique

Dans le bloc Versement automatique de la page Argent › Retrait, le titulaire du compte choisit le compte à créditer et la fréquence (« Quand verser ? ») :

• tous les 3 jours, chaque semaine (jour au choix) ou chaque mois (jour au choix ; le dernier jour du mois si le mois est plus court), à l'heure fixée par CashChap (heure de Porto-Novo) ;
• ou dès que le solde atteint un seuil (vérifié toutes les 5 minutes, au plus un versement par 24 heures).

Le montant versé est tout le solde disponible (dans la limite du maximum par retrait de l'opérateur) ou un montant fixe, avec un minimum fixé par CashChap (10 000 XOF aujourd’hui). Si le solde disponible ne couvre pas le minimum ou le montant prévu, l'échéance est sautée et un nouvel essai a lieu à l'échéance suivante. Vous êtes prévenu par e-mail et par notification à chaque versement. Les versements automatiques passent par les mêmes vérifications que les autres retraits.

Votre mot de passe est demandé pour Enregistrer et activer ou Enregistrer sans activer le réglage ; un réglage actif peut être suspendu (Suspendre) ou supprimé (Supprimer le réglage). Le bloc rappelle le réglage en cours, le prochain versement et qui l'a autorisé.

Retrait par l'API

POST /v2/payouts avec la clé secrète du service et un en-tête Idempotency-Key. Le numéro doit être un compte autorisé actif du service. Détail et exemple dans la référence de l'API.

Virements bancaires

Un virement est traité manuellement par l'équipe CashChap, aux heures ouvrées, après contrôle :

• Qui peut demander : le titulaire du service ou un administrateur, en Live, avec le dossier KYC validé (payout_owner_only, account_not_activated). Dans le portail : bloc Demander un retrait, moyen Virement bancaire.
• Frais de virement : un frais fixe par banque, à votre charge, s'ajoute au montant viré. Il est affiché avant validation (« Frais de virement : 1 000 XOF · Total débité : 51 000 XOF ») ; le montant reçu sur le compte bancaire reste le montant demandé.
• Montant réservé : dès la demande, le montant et le frais sont déduits du disponible. Ils y reviennent si la demande est annulée ou refusée.
• Annulation : possible tant que la demande est to_process (POST /v2/transactions/{id}/cancel, sinon cannot_cancel).
• Demandes en attente : leur nombre par service est limité (too_many_pending_payouts).
• Résultat : la transaction v2 donne l'état du virement dans payout.state, la banque, le compte masqué, la référence bancaire et la date de virement ; les webhooks withdrawal.pending, withdrawal.success, withdrawal.failed ou withdrawal.cancelled sont envoyés.
• Disponibilité : le service de virement peut être fermé temporairement (bank_payouts_unavailable).

Remboursements

Un remboursement rend au payeur le montant d'un paiement Mobile Money réussi, hors frais ; il est débité de votre solde disponible. Règles, délais et suivi : voir Remboursements.