Qué Mouv hace por vos automáticamente
Blacklist AML
Cada operación verifica al destinatario contra lista oficial UIAF + listas internas Mouv. Bloqueo automático con código
RECIPIENT_BLACKLISTED.Counterparty limits
Topes diarios y mensuales por tercero. Configurables por empresa. Bloqueo con código
COUNTERPARTY_*_LIMIT_EXCEEDED.Audit trail
Cada operación queda inmutablemente registrada con
apiKeyId, IP origen, timestamp, monto, destinatario, documento. Reportable a UIAF.Onboarding KYC/KYB
Tu empresa pasó por KYB antes de tener acceso a la API. Re-verificaciones periódicas según riesgo.
Qué tu integración DEBE hacer
Persistir el targetDocument
Para retiros BREB, targetDocument es obligatorio (compliance SARLAFT). Lo obtenés del response de /transfers/resolve-key:
targetDocument, Mouv rechaza con 422 TARGET_DOCUMENT_REQUIRED ANTES de mover fondos.
Para retiros ACH, el documento del titular va dentro de destination.bankAccount.documentNumber (mismo rol compliance).
Validar identidad del pagador (PSE)
Al crear un deposit PSE, los campospayerDocumentTypeId + payerDocumentNumber + payerFirstName + payerLastName son obligatorios. Mouv los valida contra blacklist UIAF antes de generar el link.
NO compartir API keys
Cada llave es atribución de auditoría: una llave revocada-tras-compromiso requiere reportar incident a Superintendencia + emitir SAR (Suspicious Activity Report) si hubo movimiento sospechoso. Llaves compartidas hacen forensics imposible.Mantener logs de tu lado
Aunque Mouv tiene audit trail completo, mantené tu propio log de:- Quién llamó cada API request (usuario interno, sistema)
- Quién aprobó cada operación financiera (si aplica multi-sig en tu sistema)
- Reason codes para refunds / cancelaciones
Reportes a UIAF
Mouv emite reportes automáticos a UIAF cuando se cumplen umbrales:- Operación individual >$10.000 USD equivalente
- Cliente con operaciones acumuladas sospechosas según patrones
- Operaciones rechazadas por blacklist
Caps por transferencia
Para montos mayores: dividí en múltiples transferencias o contactá soporte para configuración special.
Caps por contraparte (counterparty limits)
Configurables por tu empresa desde el dashboard (/configuracion/aml). Default:
- Diario: $50.000.000 COP por tercero (suma cross-rail)
- Mensual: $500.000.000 COP por tercero
Régimen tributario IVA
Las comisiones de Mouv tienen IVA 19% para empresas en régimen común colombiano. Mouv detecta automáticamente tu régimen desde tu información KYB y aplica IVA solo cuando corresponde. El campoivaApplicable en cada quote te dice si tu empresa está sujeta.
Si pensás que el flag está mal configurado, contactanos.
Sospecha de fraude
Si detectás actividad sospechosa (uso de tu API key fuera de tus sistemas, montos no autorizados):- Revocá la llave inmediatamente desde el dashboard
- Notificanos a
hola@vectora.com.cocon timestamp + transacciones sospechosas - Mouv asistirá con la documentación SAR si aplica