Versements par fichier

Payez des dizaines ou des centaines de numéros Mobile Money en une fois — paie, commissions d'agents, remboursements de masse — à partir d'un fichier CSV ou Excel. Le portail contrôle chaque ligne avant tout envoi, vous remet un rapport d'analyse, puis le lot suit le parcours habituel du Cash out : aperçu des frais, code de confirmation, exécution, suivi et rapport par ligne.

Le principe

1. Depuis Argent › Cash out › Versements par fichier, téléchargez le modèle (CSV ou Excel) et remplissez-le : un bénéficiaire par ligne.
2. Analyser le fichier : le portail lit le fichier sur le serveur et contrôle chaque ligne (numéro, opérateur, montant, doublons, référence interne). Rien n'est envoyé ni débité à cette étape. Le rapport d'analyse (CSV ou Excel) liste toutes les lignes, acceptées ou rejetées, avec la raison précise de chaque rejet.
3. Préparer le lot : les seules lignes valides forment un lot de Cash out, exactement comme un lot saisi à la main : CashChap détecte l'opérateur, calcule les frais, vérifie les plafonds et votre solde, et affiche l'aperçu (total, frais, solde après).
4. Confirmer par le code à 6 chiffres reçu par e-mail (un seul code pour tout le lot), puis Exécuter. Les lignes partent aussitôt, ou attendent la validation de CashChap selon les réglages de votre compte : mêmes règles, mêmes plafonds et mêmes journaux que le Cash out.
5. Le suivi se met à jour en direct ; le rapport par ligne (CSV ou Excel) se télécharge à tout moment, pendant et après l'exécution.

Le fichier

Formats acceptés : CSV (séparateur « ; » ou « , » ou tabulation, détecté automatiquement ; UTF-8 avec ou sans BOM, ou Windows-1252) et Excel (.xlsx, première feuille). Taille : 5 Mo au plus ; 10 000 lignes au plus analysées. Les lignes vides sont ignorées.

La première ligne porte les en-têtes (les synonymes usuels sont reconnus : telephone, phone, amount, reference, nom…). Sans en-tête, les colonnes doivent suivre l'ordre du modèle. Seules les colonnes numero et montant sont indispensables.

numero;montant;motif;reference_interne;nom_beneficiaire
2290197000000;25000;Salaire octobre;PAIE-2026-10-001;Awa Dossou
2290166000000;10000;Commission agent;COM-2026-10-017;Koffi Agbo

Les contrôles de l'analyse

Chaque ligne est acceptée ou rejetée ; une ligne rejetée n'est jamais envoyée et n'empêche pas les autres de partir. Le rapport d'analyse donne la raison de chaque rejet :

• Numéro : manquant, invalide, hors du Bénin (indicatif 229 seulement) ou sans opérateur Mobile Money reconnu (MTN ou Moov Bénin d'après le préfixe). L'opérateur affiché à l'analyse est indicatif ; CashChap le confirme à l'aperçu.
• Montant : manquant, non entier, inférieur au minimum par opération ou supérieur au plafond par opération de votre service.
• Doublons : même numéro et même montant qu'une ligne précédente ; ou même numéro avec un autre montant, car un lot ne paie un numéro qu'une fois (faites un second fichier si un bénéficiaire doit recevoir deux versements).
• Référence interne : déjà présente dans le fichier, ou déjà utilisée dans un versement des 90 derniers jours.
• Longueurs : nom (100), motif (140), référence (64).

L'analyse signale aussi, pour le lot entier : un total au-dessus du plafond par lot ou du plafond journalier, et un nombre de lignes valides supérieur au maximum d'un lot (100 lignes) : découpez alors le fichier en plusieurs fichiers, chacun donnant un lot avec son propre code.

Le rapport par ligne

Pour tout lot exécuté (importé d'un fichier ou saisi à la main), Rapport par ligne télécharge, en CSV ou Excel, une ligne par bénéficiaire : numéro (masqué : 22901••••), nom, montant, frais, motif, référence interne, statut (réussie, échouée, en attente de validation, refusée, refusée par CashChap), référence de l'opérateur pour une ligne réussie, motif d'échec pour une ligne échouée ou refusée, et l'horodatage à l'heure de votre compte. Une ligne retenue par un contrôle de sécurité de CashChap est indiquée comme telle.

Vous le retrouvez dans la liste Fichiers importés de la page (avec le rapport d'analyse et le reçu du lot) et dans le suivi d'un lot.

Sécurité et conservation

• Le fichier d'origine est archivé sur le serveur du portail, hors de toute adresse publique, avec son empreinte SHA-256 affichée dans la liste des imports : vous pouvez vérifier qu'un lot correspond bien au fichier envoyé. Il est conservé 90 jours (numéros, noms et montants), puis supprimé avec son rapport d'analyse ; la ligne de l'historique et l'empreinte restent.
• Un classeur Excel qui contient une déclaration XML (DOCTYPE ou entité) est refusé avant toute lecture : c'est le vecteur des attaques par entités externes. Enregistrez-le de nouveau depuis Excel ou LibreOffice, ou envoyez un CSV.
• Les formules d'un classeur Excel ne sont jamais exécutées : seule la valeur des cellules est lue. Dans les rapports CSV, une cellule qui commence par =, +, - ou @ est neutralisée pour qu'un tableur ne l'interprète pas comme une formule.
• Un import analysé mais jamais préparé peut être annulé ; un fichier déjà transformé en lot ne peut pas l'être une seconde fois (le lot, lui, suit le parcours du Cash out : un double clic ne crée jamais un second lot).
• Chaque étape (analyse, annulation, lot, rapport) est inscrite au journal d'activité du compte.

Questions fréquentes

• Puis-je verser deux fois au même numéro dans un fichier ? Non : un lot ne paie un numéro qu'une fois. Faites deux fichiers, ou cumulez les montants sur une ligne.
• J'ai 300 agents à payer. Un lot compte au plus 100 lignes : faites trois fichiers de 100 lignes, chacun avec son code de confirmation. L'analyse accepte un fichier plus long pour vous permettre de tout contrôler d'un coup.
• Une référence interne est refusée comme « déjà utilisée ». Un versement des 90 derniers jours la porte déjà dans ce service et ce mode : vérifiez que ce n'est pas un double paiement avant de changer la référence.
• En Sandbox ? Oui, avec les numéros de test : aucun argent ne sort.