Le Paiement de Masse vous permet d'exécuter un lot de retraits crypto à partir d'un seul fichier CSV. Chaque téléchargement est traité comme une seule opération commerciale. Chaque transaction résultante partage le même Batch ID, ce qui vous permet de suivre, rapprocher et générer des rapports sur l'ensemble du lot depuis un seul endroit.
Le Paiement de Masse est disponible à trois endroits :
- Espace Client — téléchargez, prévisualisez, enregistrez comme brouillon et confirmez avec la 2FA dans le portefeuille web.
- API Client — soumettez des lots de manière programmatique avec votre authentification API. Consultez la référence de l'API sur https://docs.xbo.com/#mass-crypto-withdrawal.
- Back Office CRM — pour les lots dépassant votre seuil d'approbation configuré, un opérateur xbo examine et approuve ou refuse l'ensemble du lot.
Avant de commencer
- Vous disposez d'un compte d'entreprise actif avec des autorisations de retrait.
- La 2FA est activée (obligatoire pour la confirmation dans l'Espace Client).
- Le solde de votre portefeuille couvre le montant total du paiement plus la commission totale.
- Si vous prévoyez de débiter une devise et de payer dans une autre (par ex. débiter USD, payer USDT), le portefeuille de la devise source doit exister et disposer d'un solde suffisant pour couvrir le montant converti plus la commission.
Étape 1 — Préparez votre CSV
Votre fichier doit respecter ces règles :
|
Règle |
Détail |
|
Type de fichier |
CSV uniquement |
|
Séparateur |
Virgule (,) ou point-virgule (;) |
|
Ligne d'en-tête |
La première ligne doit contenir les noms des colonnes |
|
Colonnes obligatoires |
Devise, Adresse, Montant (Réseau le cas échéant) |
|
Colonnes facultatives |
Nom du destinataire et champs Travel Rule / bénéficiaire (une fois activés) ; peuvent être fournis partiellement par ligne |
|
Format du montant |
Pas d'espaces ni de séparateurs de milliers ; point (.) comme décimale ; jusqu'à 8 chiffres après la décimale |
|
Format de l'adresse |
Obligatoire ; pas d'espaces ; lettres et chiffres uniquement |
|
Règle de devise |
Une devise de paiement par fichier. La devise source à débiter est un champ UI / API, pas une colonne CSV |
|
Taille du fichier |
Maximum 5 MB |
Étape 2 — Téléchargement et aperçu
- Ouvrez l'Espace Client et sélectionnez Paiement de Masse dans le menu.
- Glissez-déposez votre CSV dans la zone de téléchargement, ou cliquez pour parcourir.
- Vous pouvez éventuellement sélectionner une devise source à convertir. Le système effectue une conversion agrégée par pièce et par lot lorsque vous confirmez.
- Le système valide la structure du fichier, puis chaque ligne. Si la validation échoue à une étape, vous verrez quelle étape a échoué et pourquoi.
- Examinez l'écran d'aperçu — chaque destinataire, réseau et montant est répertorié avant l'exécution de tout paiement.
- Facultatif — Enregistrer comme brouillon. Un collègue ayant le rôle approprié peut ouvrir le brouillon, l'examiner et le confirmer avec sa propre MFA.
Étape 3 — Confirmer
Sur le récapitulatif de confirmation, vous verrez :
- Nombre de transactions dans le lot
- Montant total et commission totale
- Répartition du réseau par pièce
- Détails de la conversion de la devise source (si vous en avez sélectionné une)
Confirmez avec la 2FA. Si vous utilisez l'API Client, la demande est authentifiée à l'aide de vos identifiants API. Une fois confirmée, chaque transaction est créée avec le statut En attente et visible dans votre historique de transactions avec le nouveau Batch ID.
Étape 4 — Approbation (lorsque requise)
Votre compte dispose d'un montant maximal par lot (Max Batch) configurable qui peut être traité sans approbation du back-office. Si votre lot dépasse ce seuil, il passe à En attente d'approbation du lot. L'équipe des opérations de xbo examine le récapitulatif du lot par pièce, réseau, nombre de transactions et montant total, et approuve ou refuse l'ensemble du lot. L'approbation partielle n'est pas prise en charge.
Étape 5 — Traitement, reporting et rapprochement
- Réseaux UTXO (par ex. BTC) — le lot est envoyé comme une seule transaction on-chain multi-destinations. Les fichiers dépassant la limite de la plateforme (actuellement environ 650 destinations par transaction on-chain pour BTC) sont divisés automatiquement ; chaque division est une transaction réseau.
- Réseaux basés sur les comptes (par ex. ETH, SOL, stablecoins) — chaque ligne est envoyée comme sa propre transaction on-chain.
- Isolation des échecs — Si un lot interne échoue, les lots restants sont tout de même traités.
- Rapport de résultats — Une fois le traitement terminé, téléchargez un CSV ayant la même structure que votre entrée plus une colonne de statut / erreur par ligne.
- Relevés et historique des transactions — Chaque transaction porte le Batch ID ; vous pouvez filtrer et exporter par lot.
