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:
|
Regla |
Detalle |
|
Tipo de archivo |
Solo CSV |
|
Separador |
Coma (,) o punto y coma (;) |
|
Fila de encabezado |
La primera fila debe contener los nombres de las columnas |
|
Columnas obligatorias |
Moneda, Dirección, Monto (Red cuando corresponda) |
|
Columnas opcionales |
Nombre del destinatario y campos de Travel Rule / beneficiario (una vez activados); se pueden proporcionar parcialmente por fila |
|
Formato del monto |
Sin espacios ni separadores de miles; punto (.) como decimal; hasta 8 dígitos después del decimal |
|
Formato de la dirección |
Obligatorio; sin espacios; solo letras y números |
|
Regla de moneda |
Una moneda de pago por archivo. La moneda de origen desde la que debitar es un campo de la UI / API, no una columna del CSV |
|
Tamaño del archivo |
Máximo 5 MB |
Paso 2 — Carga y previsualización
- Abra el Área de Cliente y seleccione Pago Masivo en el menú.
- Arrastre y suelte su CSV en el área de carga, o haga clic para examinar.
- 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.
- 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é.
- Revise la pantalla de previsualización — cada destinatario, red y monto se enumeran antes de que se ejecute cualquier pago.
- 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.
