As respostas para as suas perguntas

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.

Mass Payment utiliza a sua taxa de levantamento padrão por moeda / por rede. A taxa é cobrada além do valor no seu CSV: o destinatário recebe o valor total que indicou, e a sua carteira é debitada do valor mais a taxa.

• Redes UTXO com agrupamento em lotes — a taxa é agregada por lote e apresentada na primeira linha do lote no histórico de transações e nos extratos.
• Redes baseadas em contas — cada linha é uma transação on-chain separada e tem a sua própria taxa.
• Com conversão da moeda de origem — a taxa é calculada sobre a moeda de pagamento (por ex. USDT) e a carteira de origem é debitada do equivalente convertido.

O agrupamento de taxas de rede significa enviar uma transação on-chain para vários destinatários em vez de uma transação por destinatário. Aplica-se apenas a redes UTXO.

A validação é executada nesta ordem. Se uma etapa falhar, o processamento é interrompido e a etapa com falha é exibida para você.

1. Estrutura do arquivo — nomes das colunas, tamanho do arquivo, contagem de linhas, colunas obrigatórias presentes.
2. Símbolos de linha — caracteres, formato, precisão decimal.
3. Moeda — uma única moeda de pagamento em todas as linhas.
4. Códigos de rede — válidos para a moeda quando aplicável.
5. Valor mínimo de saque por linha.
6. Saldo, limites de saque e quaisquer restrições ativas (por exemplo, uma retenção após depósito em moeda fiduciária).

Mass Payment oferece suporte à segregação de funções usando o fluxo de rascunho e pagamento posterior:

• Preparador — envia o CSV, executa a pré-visualização e salva como rascunho.
• Aprovador — abre o rascunho, revisa os destinatários e os valores, e confirma com seu próprio MFA.

Se você enviar lotes de forma programática, todas as regras acima se aplicam de maneira idêntica. Consulte a referência completa da API, incluindo endpoints, estruturas de solicitação e resposta, códigos de erro e exemplos práticos, em:

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

Verifique a linha de cabeçalho, o separador (apenas vírgula ou ponto e vírgula), o tamanho do arquivo (≤5 MB) e se as colunas Moeda, Endereço e Valor estão presentes. A mensagem de erro mostra qual coluna ou regra falhou.

O valor total excedeu o limite Máximo de Lote configurado para o processamento automático. A equipe de operações da xbo analisará e aprovará ou recusará todo o lote. Você verá a mudança de status no seu histórico de transações.

O relatório de resultados adiciona uma coluna de status / erro ao seu CSV original. Reexporte as linhas que falharam para um novo CSV, corrija o problema (muitas vezes um endereço malformado ou um valor abaixo do mínimo) e envie-as como um novo lote.

Se a conversão falhar para qualquer moeda no lote, todo o lote é cancelado. Nenhum pagamento parcial é realizado. Verifique o saldo da carteira de moeda de origem e tente novamente.

Uma vez confirmadas e processadas on-chain, as transações não podem ser revertidas. Os lotes que aguardam aprovação ainda podem ser recusados pelo operador.

Não. Uma moeda de pagamento por arquivo.

Filtre o histórico de transações ou a exportação do seu extrato por ID do Lote — cada transação no lote carrega o mesmo identificador.

Sim. Ver.