Saltar al contenido principal

​
Habilitación de CRM

Después de instalar CRM, abra el archivo .env con cualquier editor de texto y actualice las siguientes variables antes de comenzar: 
# DATA SECURITY
LCRYPTO_HASH_SECRET_KEY=my-hash-secret-key
LCRYPTO_ENCRYPT_SECRET_KEY=my-encrypt-secret-key
  • LCRYPTO_HASH_SECRET_KEY: Esta es su clave de hashing. Verifica la integridad de los datos y confirma que las solicitudes provienen de una fuente confiable.
  • LCRYPTO_ENCRYPT_SECRET_KEY: Esta es su clave de cifrado. Protege datos sensibles cifrándolos y los descifra cuando sea necesario.
Necesitará generar estas claves usted mismo y pegarlas en el archivo .env. Puede usar el siguiente comando para generar las claves:
  • Cada clave debe ser única, por lo que tendrá que ejecutar el comando dos veces, una vez para cada clave, para generar valores separados y seguros.

​
Generar una clave de hashing

openssl rand -hex 32

​
Generar una clave de cifrado

openssl rand -hex 32
ImportanteMantenga sus claves seguras.Una vez generadas, almacene sus claves de forma segura. Recomendamos usar un Secret Manager para protegerlas de la exposición.

​
Uso típico

Así es como puede comenzar:

​
Paso 1 – Crear el Titular

Comience creando un Titular, que representa a un individuo u organización en el sistema.
AtenciónAunque muchos campos están marcados como opcionales a nivel del contrato de API, algunos plugins (como CRM o integraciones KYC) pueden requerirlos.Si no está seguro, verifique los requisitos específicos del plugin antes de proceder.
También tenga en cuenta:
  • La API no valida la exactitud de los datos.
  • Proporcionar valores incorrectos (como ledgerId o accountId que no coinciden) puede resultar en fallas de integración, especialmente con proveedores externos o el componente Ledger.
Tenga especial cuidado al proporcionar identificadores válidos y datos reales cuando sea necesario.
También puede realizar acciones como:

​
Paso 2 – Conectar el titular a Midaz usando una Cuenta Alias

Una vez que se crea el titular, use el endpoint Crear una Cuenta Alias para configurar una Cuenta Alias (una cuenta a nivel de CRM que representa la Cuenta de Midaz) y vincular el Titular a él en un solo paso. Este vínculo es clave para:
  • Rastrear transacciones vinculadas al titular.
  • Habilitar tarifas, notificaciones y otras características a nivel de cuenta.
  • Impulsar flujos posteriores como facturación y verificación de identidad.
Sin esta conexión, la mayoría de las características impulsadas por CRM no funcionarán como se espera.
También puede realizar acciones como:

​
¿Qué sucede después?

Con los titulares correctamente creados y vinculados, ahora puede:
  • Enriquecer los datos del CRM con plugins adicionales (p.ej., KYC, scoring, segmentación).
  • Activar flujos de trabajo que dependen de atributos de identidad u organizacionales.
  • Validar o filtrar transacciones basadas en datos a nivel de persona.
El plugin CRM establece la base; lo que construya encima depende de usted.