Vos questions ont une réponse

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 :

Étape 2 — Téléchargement et aperçu

1. Ouvrez l'Espace Client et sélectionnez Paiement de Masse dans le menu.
2. Glissez-déposez votre CSV dans la zone de téléchargement, ou cliquez pour parcourir.
3. 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.
4. 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.
5. Examinez l'écran d'aperçu — chaque destinataire, réseau et montant est répertorié avant l'exécution de tout paiement.
6. 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.

Mass Payment utilise vos frais de retrait standard par pièce / par réseau. Les frais sont prélevés en plus du montant indiqué dans votre CSV : le destinataire reçoit le montant intégral que vous avez saisi, et votre portefeuille est débité du montant majoré des frais.

• Réseaux UTXO avec regroupement par lots — les frais sont agrégés par lot et affichés sur la première ligne du lot dans l'historique des transactions et les relevés.
• Réseaux basés sur les comptes — chaque ligne est une transaction on-chain distincte et comporte ses propres frais.
• Avec conversion de la devise source — les frais sont calculés sur la devise de paiement (par ex. USDT) et le portefeuille source est débité de l'équivalent converti.

Le regroupement des frais de réseau consiste à envoyer une seule transaction on-chain pour plusieurs destinataires au lieu d'une transaction par destinataire. Il s'applique uniquement aux réseaux UTXO.

La validation s'exécute dans cet ordre. Si une étape échoue, le traitement s'arrête et l'étape ayant échoué vous est indiquée.

1. Structure du fichier — noms des colonnes, taille du fichier, nombre de lignes, colonnes obligatoires présentes.
2. Symboles de ligne — caractères, format, précision décimale.
3. Devise — une seule devise de paiement pour toutes les lignes.
4. Codes de réseau — valides pour la devise le cas échéant.
5. Montant minimum de retrait par ligne.
6. Solde, limites de retrait et toute restriction active (par exemple, une suspension après un dépôt en monnaie fiduciaire).

Mass Payment prend en charge la séparation des tâches grâce au flux de brouillon et de paiement différé :

• Préparateur — téléverse le CSV, exécute l'aperçu et enregistre comme brouillon.
• Approbateur — ouvre le brouillon, vérifie les destinataires et les montants, et confirme avec sa propre MFA.

Si vous soumettez des lots de manière programmatique, toutes les règles ci-dessus s'appliquent à l'identique. Consultez la référence complète de l'API, y compris les points de terminaison, les structures de requête et de réponse, les codes d'erreur et des exemples concrets, à l'adresse :

https://docs.xbo.com/#mass-crypto-withdrawal

Vérifiez la ligne d'en-tête, le séparateur (virgule ou point-virgule uniquement), la taille du fichier (≤5 MB) et que les colonnes Devise, Adresse et Montant sont présentes. Le message d'erreur indique quelle colonne ou quelle règle a échoué.

Le montant total a dépassé le seuil Lot Maximum que vous avez configuré pour le traitement automatique. L'équipe des opérations de xbo examinera et approuvera ou refusera l'ensemble du lot. Vous verrez le changement de statut dans votre historique de transactions.

Le rapport de résultats ajoute une colonne de statut / erreur à votre CSV d'origine. Réexportez les lignes ayant échoué dans un nouveau CSV, corrigez le problème (souvent une adresse mal formée ou un montant inférieur au minimum) et soumettez-les en tant que nouveau lot.

Si la conversion échoue pour une pièce quelconque du lot, l'ensemble du lot est abandonné. Aucun paiement partiel n'est effectué. Vérifiez le solde du portefeuille de la devise source et réessayez.

Une fois confirmées et traitées on-chain, les transactions ne peuvent pas être annulées. Les lots en attente d'approbation peuvent encore être refusés par l'opérateur.

Non. Une seule devise de paiement par fichier.

Filtrez l'historique des transactions ou l'exportation de votre relevé par ID de lot — chaque transaction du lot porte le même identifiant.

Oui. Voir.