Central de ajuda

As respostas para as suas perguntas

  • XBO.com - Image 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:

    Regra

    Detalhe

    Tipo de arquivo

    Apenas CSV

    Separador

    Vírgula (,) ou ponto e vírgula (;)

    Linha de cabeçalho

    A primeira linha deve conter os nomes das colunas

    Colunas obrigatórias

    Moeda, Endereço, Valor (Rede quando aplicável)

    Colunas opcionais

    Nome do destinatário e campos de Travel Rule / beneficiário (uma vez ativados); podem ser fornecidos parcialmente por linha

    Formato do valor

    Sem espaços ou separadores de milhares; ponto (.) como decimal; até 8 dígitos após o decimal

    Formato do endereço

    Obrigatório; sem espaços; apenas letras e números

    Regra de moeda

    Uma moeda de pagamento por arquivo. A moeda de origem a ser debitada é um campo da UI / API, não uma coluna do CSV

    Tamanho do arquivo

    Máximo de 5 MB


    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.
  • XBO.com - Image Quais são as taxas?

    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.