Il Pagamento di Massa ti consente di eseguire un batch di prelievi di cripto da un singolo file CSV. Ogni caricamento è trattato come una singola operazione aziendale. Ogni transazione risultante condivide lo stesso Batch ID, così puoi tracciare, riconciliare e generare report sull'intero batch da un unico posto.
Il Pagamento di Massa è disponibile in tre posti:
- Area Cliente — carica, visualizza l'anteprima, salva come bozza e conferma con 2FA nel wallet web.
- API Cliente — invia i batch in modo programmatico con la tua autenticazione API. Consulta il riferimento API su https://docs.xbo.com/#mass-crypto-withdrawal.
- Back Office CRM — per i batch superiori alla soglia di approvazione configurata, un operatore xbo esamina e approva o rifiuta l'intero batch.
Prima di iniziare
- Hai un account aziendale attivo con permessi di prelievo.
- Il 2FA è abilitato (obbligatorio per la conferma nell'Area Cliente).
- Il saldo del tuo wallet copre l'importo totale del pagamento più la commissione totale.
- Se prevedi di addebitare una valuta e pagare in un'altra (ad es. addebitare USD, pagare USDT), il wallet della valuta di origine deve esistere e avere un saldo sufficiente per coprire l'importo convertito più la commissione.
Passaggio 1 — Prepara il tuo CSV
Il tuo file deve seguire queste regole:
|
Regola |
Dettaglio |
|
Tipo di file |
Solo CSV |
|
Separatore |
Virgola (,) o punto e virgola (;) |
|
Riga di intestazione |
La prima riga deve contenere i nomi delle colonne |
|
Colonne obbligatorie |
Valuta, Indirizzo, Importo (Rete ove applicabile) |
|
Colonne facoltative |
Nome del destinatario e campi Travel Rule / beneficiario (una volta attivati); possono essere forniti parzialmente per riga |
|
Formato dell'importo |
Nessuno spazio o separatore delle migliaia; punto (.) come decimale; fino a 8 cifre dopo il decimale |
|
Formato dell'indirizzo |
Obbligatorio; nessuno spazio; solo lettere e numeri |
|
Regola della valuta |
Una valuta di pagamento per file. La valuta di origine da addebitare è un campo UI / API, non una colonna CSV |
|
Dimensione del file |
Massimo 5 MB |
Passaggio 2 — Caricamento e anteprima
- Apri l'Area Cliente e seleziona Pagamento di Massa dal menu.
- Trascina e rilascia il tuo CSV nell'area di caricamento, oppure fai clic per sfogliare.
- Facoltativamente, seleziona una valuta di origine da cui convertire. Il sistema esegue una conversione aggregata per moneta per batch quando confermi.
- Il sistema convalida la struttura del file, poi ogni riga. Se la convalida fallisce in qualsiasi passaggio, vedrai quale passaggio è fallito e perché.
- Esamina la schermata di anteprima — ogni destinatario, rete e importo è elencato prima che venga eseguito qualsiasi pagamento.
- Facoltativo — Salva come bozza. Un collega con il ruolo adeguato può aprire la bozza, esaminarla e confermarla con il proprio MFA.
Passaggio 3 — Conferma
Nel riepilogo di conferma vedrai:
- Numero di transazioni nel batch
- Importo totale e commissione totale
- Ripartizione della rete per moneta
- Dettagli della conversione della valuta di origine (se ne hai selezionata una)
Conferma con 2FA. Se usi l'API Cliente, la richiesta viene autenticata utilizzando le tue credenziali API. Una volta confermata, ogni transazione viene creata con stato In sospeso ed è visibile nella tua cronologia delle transazioni con il nuovo Batch ID.
Passaggio 4 — Approvazione (quando richiesta)
Il tuo account ha un importo massimo per batch (Max Batch) configurabile che può essere elaborato senza l'approvazione del back-office. Se il tuo batch supera tale soglia, passa a In attesa di approvazione del batch. Il team operativo di xbo esamina il riepilogo del batch per moneta, rete, numero di transazioni e importo totale e approva o rifiuta l'intero batch. L'approvazione parziale non è supportata.
Passaggio 5 — Elaborazione, reportistica e riconciliazione
- Reti UTXO (ad es. BTC) — il batch viene inviato come un'unica transazione on-chain multi-destinazione. I file più grandi del limite della piattaforma (attualmente circa 650 destinazioni per transazione on-chain per BTC) vengono suddivisi automaticamente; ogni suddivisione è una transazione di rete.
- Reti basate su account (ad es. ETH, SOL, stablecoin) — ogni riga viene inviata come la propria transazione on-chain.
- Isolamento dei guasti — Se un batch interno fallisce, i batch rimanenti vengono comunque elaborati.
- Report dei risultati — Una volta completata l'elaborazione, scarica un CSV con la stessa struttura del tuo input più una colonna di stato / errore per riga.
- Estratti conto e cronologia delle transazioni — Ogni transazione porta il Batch ID; puoi filtrare ed esportare per batch.
