Respuestas a sus preguntas

El Pago Masivo le permite ejecutar un lote de retiros de cripto desde un único archivo CSV. Cada carga se trata como una sola operación comercial. Cada transacción resultante comparte el mismo Batch ID, por lo que puede rastrear, conciliar e informar sobre todo el lote desde un único lugar.

El Pago Masivo está disponible en tres lugares:

• Área de Cliente — cargue, previsualice, guarde como borrador y confirme con 2FA en la billetera web.
• API de Cliente — envíe lotes de forma programática con su autenticación de API. Consulte la referencia de la API en https://docs.xbo.com/#mass-crypto-withdrawal.
• Back Office del CRM — para lotes que superen su umbral de aprobación configurado, un operador de xbo revisa y aprueba o rechaza todo el lote.

Antes de empezar

• Tiene una cuenta corporativa activa con permisos de retiro.
• 2FA está habilitado (obligatorio para la confirmación en el Área de Cliente).
• El saldo de su billetera cubre el monto total del pago más la comisión total.
• Si planea debitar una moneda y pagar en otra (p. ej. debitar USD, pagar USDT), la billetera de la moneda de origen debe existir y tener saldo suficiente para cubrir el monto convertido más la comisión.

Paso 1 — Prepare su CSV

Su archivo debe seguir estas reglas:

Paso 2 — Carga y previsualización

1. Abra el Área de Cliente y seleccione Pago Masivo en el menú.
2. Arrastre y suelte su CSV en el área de carga, o haga clic para examinar.
3. Opcionalmente, seleccione una moneda de origen desde la que convertir. El sistema realiza una conversión agregada por moneda y por lote cuando usted confirma.
4. El sistema valida la estructura del archivo y luego cada fila. Si la validación falla en algún paso, verá qué paso falló y por qué.
5. Revise la pantalla de previsualización — cada destinatario, red y monto se enumeran antes de que se ejecute cualquier pago.
6. Opcional — Guardar como borrador. Un colega con el rol adecuado puede abrir el borrador, revisarlo y confirmarlo con su propia MFA.

Paso 3 — Confirmar

En el resumen de confirmación verá:

• Número de transacciones en el lote
• Monto total y comisión total
• Desglose de red por moneda
• Detalles de la conversión de la moneda de origen (si seleccionó una)

Confirme con 2FA. Si utiliza la API de Cliente, la solicitud se autentica mediante sus credenciales de API. Una vez confirmada, cada transacción se crea en estado Pendiente y es visible en su historial de transacciones con el nuevo Batch ID.

Paso 4 — Aprobación (cuando se requiere)

Su cuenta tiene un monto máximo de lote (Max Batch) configurable que puede procesarse sin aprobación del back-office. Si su lote supera ese umbral, pasa a Esperando Aprobación del Lote. El equipo de operaciones de xbo revisa el resumen del lote por moneda, red, número de transacciones y monto total, y aprueba o rechaza todo el lote. No se admite la aprobación parcial.

Paso 5 — Procesamiento, informes y conciliación

• Redes UTXO (p. ej. BTC) — el lote se envía como una única transacción on-chain de múltiples destinos. Los archivos que superan el límite de la plataforma (actualmente alrededor de 650 destinos por transacción on-chain para BTC) se dividen automáticamente; cada división es una transacción de red.
• Redes basadas en cuentas (p. ej. ETH, SOL, stablecoins) — cada fila se envía como su propia transacción on-chain.
• Aislamiento de fallos — Si un lote interno falla, los lotes restantes se siguen procesando.
• Informe de resultados — Una vez completado el procesamiento, descargue un CSV con la misma estructura que su entrada más una columna de estado / error por fila.
• Extractos e historial de transacciones — Cada transacción lleva el Batch ID; puede filtrar y exportar por lote.

Mass Payment utiliza tu comisión de retiro estándar por moneda / por red. La comisión se cobra además del importe de tu CSV: el destinatario recibe el importe completo que indicaste, y se debita de tu monedero el importe más la comisión.

• Redes UTXO con agrupación por lotes — la comisión se agrega por lote y se muestra en la primera fila del lote en el historial de transacciones y en los extractos.
• Redes basadas en cuentas — cada fila es una transacción on-chain independiente y conlleva su propia comisión.
• Con conversión de moneda de origen — la comisión se calcula sobre la moneda de pago (p. ej. USDT) y se debita del monedero de origen el equivalente convertido.

El agrupamiento de comisiones de red significa enviar una sola transacción on-chain para muchos destinatarios en lugar de una transacción por destinatario. Solo se aplica a las redes UTXO.

La validación se ejecuta en este orden. Si un paso falla, el procesamiento se detiene y se le muestra el paso fallido.

1. Estructura del archivo — nombres de columnas, tamaño del archivo, recuento de filas, columnas obligatorias presentes.
2. Símbolos de fila — caracteres, formato, precisión decimal.
3. Moneda — una única moneda de pago en todas las filas.
4. Códigos de red — válidos para la moneda cuando corresponda.
5. Importe mínimo de retiro por fila.
6. Saldo, límites de retiro y cualquier restricción activa (por ejemplo, una retención posterior al depósito en moneda fiduciaria).

Mass Payment admite la segregación de funciones mediante el flujo de borrador y pago posterior:

• Preparador — sube el CSV, ejecuta la vista previa y guarda como borrador.
• Aprobador — abre el borrador, revisa los destinatarios y los importes, y confirma con su propio MFA.

Si envías lotes de forma programática, todas las reglas anteriores se aplican de manera idéntica. Consulta la referencia completa de la API, incluidos los endpoints, las estructuras de solicitud y respuesta, los códigos de error y ejemplos prácticos, en:

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

Verifica la fila de encabezado, el separador (solo coma o punto y coma), el tamaño del archivo (≤5 MB) y que las columnas Moneda, Dirección e Importe estén presentes. El mensaje de error muestra qué columna o regla falló.

El importe total superó el umbral Máximo de Lote configurado para el procesamiento automático. El equipo de operaciones de xbo revisará y aprobará o rechazará todo el lote. Verás el cambio de estado en tu historial de transacciones.

El informe de resultados agrega una columna de estado / error a tu CSV original. Vuelve a exportar las filas fallidas a un nuevo CSV, corrige el problema (a menudo una dirección mal formada o un importe por debajo del mínimo) y envíalas como un nuevo lote.

Si la conversión falla para cualquier moneda del lote, todo el lote se cancela. No se realizan pagos parciales. Verifica el saldo de la billetera de moneda de origen e inténtalo de nuevo.

Una vez confirmadas y procesadas en la cadena, las transacciones no se pueden revertir. Los lotes que esperan aprobación aún pueden ser rechazados por el operador.

No. Una moneda de pago por archivo.

Filtra el historial de transacciones o la exportación de tu extracto por ID de Lote — cada transacción del lote lleva el mismo identificador.

Sí. Ver.