Le tue domande hanno risposta

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:

Passaggio 2 — Caricamento e anteprima

1. Apri l'Area Cliente e seleziona Pagamento di Massa dal menu.
2. Trascina e rilascia il tuo CSV nell'area di caricamento, oppure fai clic per sfogliare.
3. Facoltativamente, seleziona una valuta di origine da cui convertire. Il sistema esegue una conversione aggregata per moneta per batch quando confermi.
4. Il sistema convalida la struttura del file, poi ogni riga. Se la convalida fallisce in qualsiasi passaggio, vedrai quale passaggio è fallito e perché.
5. Esamina la schermata di anteprima — ogni destinatario, rete e importo è elencato prima che venga eseguito qualsiasi pagamento.
6. 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.

Mass Payment utilizza la tua commissione di prelievo standard per moneta / per rete. La commissione viene addebitata oltre all'importo nel tuo CSV: il destinatario riceve l'intero importo che hai indicato e dal tuo portafoglio viene addebitato l'importo più la commissione.

• Reti UTXO con raggruppamento in batch — la commissione viene aggregata per batch e mostrata sulla prima riga del batch nella cronologia delle transazioni e negli estratti conto.
• Reti basate su account — ogni riga è una transazione on-chain separata e comporta la propria commissione.
• Con conversione della valuta di origine — la commissione viene calcolata sulla valuta di pagamento (ad es. USDT) e dal portafoglio di origine viene addebitato l'equivalente convertito.

Il raggruppamento delle commissioni di rete consiste nell'inviare una singola transazione on-chain per molti destinatari anziché una transazione per destinatario. Si applica solo alle reti UTXO.

La convalida viene eseguita in questo ordine. Se un passaggio non riesce, l'elaborazione si interrompe e ti viene mostrato il passaggio non riuscito.

1. Struttura del file — nomi delle colonne, dimensione del file, conteggio delle righe, colonne obbligatorie presenti.
2. Simboli di riga — caratteri, formato, precisione decimale.
3. Valuta — un'unica valuta di pagamento per tutte le righe.
4. Codici di rete — validi per la valuta ove applicabile.
5. Importo minimo di prelievo per riga.
6. Saldo, limiti di prelievo ed eventuali restrizioni attive (ad esempio, un blocco successivo al deposito in valuta fiat).

Mass Payment supporta la separazione dei compiti utilizzando il flusso di bozza e pagamento differito:

• Preparatore — carica il CSV, esegue l'anteprima e salva come bozza.
• Approvatore — apre la bozza, esamina i destinatari e gli importi, e conferma con la propria MFA.

Se invii i batch in modo programmatico, tutte le regole sopra indicate si applicano in modo identico. Consulta il riferimento completo dell'API, inclusi gli endpoint, le strutture di richiesta e risposta, i codici di errore ed esempi pratici, all'indirizzo:

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

Controlla la riga di intestazione, il separatore (solo virgola o punto e virgola), la dimensione del file (≤5 MB) e che le colonne Valuta, Indirizzo e Importo siano presenti. Il messaggio di errore mostra quale colonna o regola non è stata superata.

L'importo totale ha superato la soglia Batch Massimo configurata per l'elaborazione automatica. Il team operativo di xbo esaminerà e approverà o rifiuterà l'intero batch. Vedrai il cambiamento di stato nella tua cronologia delle transazioni.

Il report dei risultati aggiunge una colonna di stato / errore al tuo CSV originale. Riesporta le righe non riuscite in un nuovo CSV, correggi il problema (spesso un indirizzo malformato o un importo inferiore al minimo) e inviale come nuovo batch.

Se la conversione non riesce per qualsiasi moneta del batch, l'intero batch viene interrotto. Non vengono effettuati pagamenti parziali. Controlla il saldo del portafoglio della valuta di origine e riprova.

Una volta confermate ed elaborate on-chain, le transazioni non possono essere annullate. I batch in attesa di approvazione possono ancora essere rifiutati dall'operatore.

No. Una valuta di pagamento per file.

Filtra la cronologia delle transazioni o l'esportazione del tuo estratto conto per ID Batch — ogni transazione nel batch riporta lo stesso identificativo.

Sì. Vedi.