O que é o Pagamento em Massa?

O Pagamento em Massa permite que você execute um lote de saques de cripto a partir de um único arquivo CSV. Cada upload é tratado como uma única operação comercial. Cada transação resultante compartilha o mesmo Batch ID, para que você possa rastrear, conciliar e gerar relatórios sobre todo o lote em um só lugar.

O Pagamento em Massa está disponível em três lugares:

• Área do Cliente — faça upload, visualize, salve como rascunho e confirme com 2FA na carteira web.
• API do Cliente — envie lotes de forma programática com sua autenticação de API. Consulte a referência da API em https://docs.xbo.com/#mass-crypto-withdrawal.
• Back Office do CRM — para lotes acima do seu limite de aprovação configurado, um operador da xbo revisa e aprova ou recusa todo o lote.

Antes de começar

• Você tem uma conta corporativa ativa com permissões de saque.
• O 2FA está habilitado (obrigatório para a confirmação na Área do Cliente).
• O saldo da sua carteira cobre o valor total do pagamento mais a comissão total.
• Se você planeja debitar uma moeda e pagar em outra (por exemplo, debitar USD, pagar USDT), a carteira da moeda de origem deve existir e ter saldo suficiente para cobrir o valor convertido mais a comissão.

Passo 1 — Prepare seu CSV

Seu arquivo deve seguir estas regras:

Passo 2 — Upload e visualização

1. Abra a Área do Cliente e selecione Pagamento em Massa no menu.
2. Arraste e solte seu CSV na área de upload, ou clique para procurar.
3. Opcionalmente, selecione uma moeda de origem para converter. O sistema realiza uma conversão agregada por moeda por lote quando você confirma.
4. O sistema valida a estrutura do arquivo e, em seguida, cada linha. Se a validação falhar em qualquer etapa, você verá qual etapa falhou e por quê.
5. Revise a tela de visualização — cada destinatário, rede e valor é listado antes que qualquer pagamento seja executado.
6. Opcional — Salvar como rascunho. Um colega com a função adequada pode abrir o rascunho, revisá-lo e confirmá-lo com seu próprio MFA.

Passo 3 — Confirmar

No resumo de confirmação você verá:

• Número de transações no lote
• Valor total e comissão total
• Detalhamento da rede por moeda
• Detalhes da conversão da moeda de origem (se você selecionou uma)

Confirme com 2FA. Se você usar a API do Cliente, a solicitação é autenticada usando suas credenciais de API. Uma vez confirmada, cada transação é criada com status Pendente e fica visível no seu histórico de transações com o novo Batch ID.

Passo 4 — Aprovação (quando necessário)

Sua conta tem um valor máximo de lote (Max Batch) configurável que pode ser processado sem aprovação do back-office. Se o seu lote exceder esse limite, ele passa para Aguardando Aprovação do Lote. A equipe de operações da xbo revisa o resumo do lote por moeda, rede, contagem de transações e valor total, e aprova ou recusa todo o lote. A aprovação parcial não é suportada.

Passo 5 — Processamento, relatórios e conciliação

• Redes UTXO (por exemplo, BTC) — o lote é enviado como uma única transação on-chain de múltiplos destinos. Arquivos maiores que o limite da plataforma (atualmente cerca de 650 destinos por transação on-chain para BTC) são divididos automaticamente; cada divisão é uma transação de rede.
• Redes baseadas em contas (por exemplo, ETH, SOL, stablecoins) — cada linha é enviada como sua própria transação on-chain.
• Isolamento de falhas — Se um lote interno falhar, os lotes restantes ainda são processados.
• Relatório de resultados — Quando o processamento for concluído, baixe um CSV com a mesma estrutura da sua entrada mais uma coluna de status / erro por linha.
• Extratos e histórico de transações — Cada transação carrega o Batch ID; você pode filtrar e exportar por lote.