Cuentas Externas del Comercio
Configuración de cuentas bancarias y billeteras cripto para recibir fondos
Cuentas Externas del Comercio
Configura las cuentas bancarias externas y billeteras cripto de tu comercio para recibir fondos de liquidaciones de cuenta virtual y compras de criptomonedas.
¿Qué son las Cuentas Externas del Comercio?
Las Cuentas Externas del Comercio son las cuentas bancarias y billeteras cripto propias de tu organización donde recibes fondos de las operaciones de Koywe.
Tipos de Cuentas Externas
Tus cuentas bancarias empresariales para recibir liquidaciones fiat y retiros
Tus direcciones de billetera cripto para recibir criptomonedas de deals ONRAMP
Cuentas Bancarias Externas vs Cuentas Virtuales
Entendiendo la diferencia:
Liquidación Automática: Los fondos en cuentas virtuales se liquidan automáticamente a tu cuenta bancaria externa registrada después de un período configurado (típicamente 1-7 días). También puedes solicitar retiros manualmente.
Configuración de Cuentas Bancarias Externas
Cuándo Necesitas una Cuenta Bancaria Externa
✅ Requerido para:
- Recibir liquidaciones automáticas de cuentas virtuales
- Retirar fondos de saldos virtuales
- Recibir pagos del comercio
- Cumplimiento y verificación
Creando una Cuenta Bancaria Externa
Asociación Automática: Las cuentas bancarias se asocian automáticamente con la información comercial registrada de tu comercio. No es necesario enviar nombre del titular o números de documento - usamos la información ya en el sistema.
Campos Requeridos por País
Flexibilidad del Código Bancario: Para la mayoría de los países, el código bancario puede deducirse del número de cuenta. Aún puedes proporcionarlo, pero la API validará contra el valor deducido. Para países donde es requerido, la validación asegura que el banco esté en la lista soportada.
Chile 🇨🇱
Validaciones: El código bancario debe estar en la lista de bancos válidos.
Colombia 🇨🇴
Validaciones: El tipo de cuenta debe ser soportado por el banco. Longitud del número de cuenta validada (mín/máx).
Brasil 🇧🇷
Validaciones: Código bancario deducido del número de cuenta. PIX key puede usarse en lugar del número de cuenta.
México 🇲🇽
Validaciones: Validación formato CLABE (18 dígitos). Validación dígito verificador. Banco deducido de CLABE.
Argentina 🇦🇷
Validaciones: Validación formato CVU/CBU. Validación dígito verificador. Banco deducido del número de cuenta. Alias soportado.
Perú 🇵🇪
Validaciones: Validación formato CCI (20 dígitos). Banco deducido del número de cuenta.
Bolivia 🇧🇴
Validaciones: Banco deducido del número de cuenta.
Estados Unidos 🇺🇸
Validaciones: Banco deducido del routing number. Banco genérico guardado si no se encuentra.
Proceso de Verificación
Verificación Automática: La cuenta bancaria se vincula automáticamente con la información comercial registrada de tu comercio. Asegúrate de que tu perfil de comercio tenga el nombre legal correcto y el ID fiscal, ya que se usarán para la verificación de cuenta.
Listando Cuentas Bancarias del Comercio
Configuración de Billeteras Cripto Externas
Cuándo Necesitas una Billetera Cripto Externa
✅ Requerido para:
- Recibir criptomoneda de deals ONRAMP
- Enviar cripto a tus propias soluciones de custodia
- Tenencias cripto a largo plazo fuera de Koywe
Billeteras Integradas vs Externas: Koywe proporciona billeteras integradas automáticamente (vía endpoint /wallet). Las billeteras externas son TUS PROPIAS billeteras en dispositivos hardware, exchanges, u otras soluciones de custodia donde quieres recibir cripto.
Agregando una Billetera Cripto Externa
Redes y Monedas Soportadas
Coincidencia de Red Crítica: Al crear deals ONRAMP, el parámetro network debe coincidir con una de las redes de billeteras externas registradas. ¡Siempre verifica la red antes de enviar cripto!
Listando Billeteras Cripto Externas
Usando Cuentas Externas en Operaciones
ONRAMP: Enviar Cripto a Billetera Externa
Al crear deals ONRAMP, especifica tu billetera externa como destino:
Usar Integradas vs Externas: Para cripto operacional (trading frecuente, OFFRAMP), usa billeteras integradas. Para tenencias a largo plazo o requisitos específicos de custodia, usa billeteras externas.
Retiros: Mover Fondos a Cuenta Bancaria Externa
Solicita retiro de cuenta virtual a tu cuenta bancaria externa:
Liquidaciones Automáticas: Si tienes liquidaciones automáticas habilitadas, los fondos se transferirán a tu cuenta bancaria externa primaria automáticamente después del período de retención configurado. Los retiros manuales te dan más control sobre el tiempo.
Mejores Prácticas
Seguridad
Siempre verifica dos veces las direcciones de billetera cripto antes de agregarlas. Los errores son irreversibles.
Envía transacciones de prueba pequeñas a nuevas billeteras externas antes de transferencias grandes.
Configura webhooks para rastrear liquidaciones y retiros a cuentas externas.
Mantén registros de todas las cuentas externas para cumplimiento y auditoría.
Gestión de Cuentas
✅ Hacer:
- Mantener cuentas primarias actualizadas
- Verificar nuevas cuentas inmediatamente
- Usar billeteras separadas por red
- Documentar propósitos de cuentas internamente
❌ No hacer:
- Compartir credenciales de cuenta
- Usar direcciones de depósito de exchange como billeteras externas (usar direcciones de retiro)
- Agregar billeteras no verificadas o de prueba en producción
- Usar cuentas personales para operaciones comerciales
Patrones Comunes
Configuración Multi-Moneda
Para negocios que operan en múltiples países:
Configuración Cripto Multi-Red
Para tenencias cripto diversificadas: