Usuario API y Autenticación

Los Usuarios API son cuentas especiales dentro de tu compañía en Duemint que permiten a tus sistemas integrarse directamente con la API.

Funcionan como cualquier otro usuario: tienen nombre, roles y permisos, pero en vez de ingresar a la aplicación, se autentican mediante un token JWT para interactuar con la API.

¿Qué es un Usuario API?

Un usuario API es un tipo de usuario que creas en Duemint específicamente para conectar tus sistemas propios con la plataforma.

Al crearlo, se genera un token que te permite autenticar tus integraciones y automatizar acciones dentro de Duemint (por ejemplo, crear pagos).

Al igual que un usuario normal, el usuario API tiene roles y permisos dentro de tu organización.

Esto significa que las acciones que podrá ejecutar a través de la API dependerán del rol asignado, manteniendo control y trazabilidad sobre todo lo que se haga desde integraciones externas.

Cómo crear un Usuario API

Ingresa a tu cuenta en Duemint.
Ve a Configuración → Usuarios → pestaña API.
Haz clic en Crear Usuario API.
Define un nombre y correo - El correo debe ser usado solo para este usuario API.
Asigna los roles (ej: Admin).
Guarda el usuario y copia el token JWT que se genera.

ℹ️

Nota: el token del Usuario API se mostrará solo una vez al momento de crearlo. Asegúrate de copiarlo y guardarlo en un lugar seguro.

Cómo usar el token

Una vez creado tu usuario API, se generará un token JWT que deberás incluir en cada request para autenticar tus integraciones.

Incluye el token en el header estándar Authorization: Bearer.
Indica también el companyID para que la API sepa en qué tenant operar.

ℹ️

Importante: Este companyID se solicita a través del equipo de soporte de Duemint, tanto para el entorno de producción como para sandbox.

curl --request GET \
     --url https://api.sandbox.duemint.com/api/v1/payments-out \
     --header 'accept: application/json' \
     --header 'Authorization: Bearer {API_USER_TOKEN}' \
     --header 'X-Duemint-Company-Id: {COMPANY_ID}'

Llave pública (PRONTO)

En futuras versiones podrás asociar una llave pública al Usuario API.

Esto permitirá:

Firmar automáticamente solicitudes que hoy requieren aprobación manual en la app.
Configurar una fecha de expiración de la llave.
Autorizar/desautorizar la llave desde la app.

📌

Esta funcionalidad aún no está disponible en la esta versión, pero debe considerarse desde ya en la planificación de integraciones.