Ambientes

Para facilitar la integración y las pruebas, Duemint proporciona dos entornos distintos:

• Ambiente Sandbox: Este entorno está destinado a pruebas y desarrollo, permitiendo a los desarrolladores testear sus integraciones sin afectar datos de producción. Las características y restricciones son idénticas a las del ambiente de producción, pero los datos y las transacciones son aislados para propósitos de pruebas.
  URL del ambiente Sandbox: https://api.sandbox.duemint.com
• Ambiente de Producción: Una vez que las pruebas y el desarrollo están completos y validados en el ambiente Sandbox, se puede migrar a este entorno para operar con datos reales y transacciones efectivas.
  URL del ambiente de Producción: https://api.duemint.com

Cada entorno requiere tokens distintos, por lo que los tokens generados para el Sandbox no son válidos en el ambiente de producción, y viceversa.

Recomendaciones

Es crucial desarrollar inicialmente contra el ambiente Sandbox para asegurarse de que todas las integraciones funcionan según lo esperado antes de pasar al ambiente de producción. Esto no solo previene posibles errores o problemas en un entorno en vivo, sino que también asegura que todas las funcionalidades cumplen con las normativas y restricciones impuestas por la política de KYC de Duemint.

Ambiente Sandbox de la API de Duemint

El ambiente Sandbox de Duemint está diseñado específicamente para que puedas realizar pruebas y desarrollo de tus integraciones sin afectar los datos de producción. Este entorno te permite probar todas las funcionalidades de la API en un ambiente completamente aislado.
Características del ambiente Sandbox:

• Aislamiento completo: El ambiente Sandbox opera en bases de datos y ubicaciones separadas del ambiente de producción, asegurando un entorno seguro para tus pruebas.
• Similitud con producción: Las características y restricciones en el ambiente Sandbox son idénticas a las del ambiente de producción, permitiéndote realizar pruebas realistas.
• Datos y transacciones de prueba: Todos los datos y transacciones realizados en Sandbox son aislados y utilizados únicamente para propósitos de pruebas.
• Generación de token para el ambiente Sandbox

Para trabajar con el ambiente Sandbox, necesitas generar un token de autenticación específico para este entorno. Este token se obtiene desde la plataforma de Duemint y se utilizará para todas las solicitudes dentro del ambiente de pruebas.

¿Qué es un Usuario API?

• Es un usuario que creas desde la app de Duemint: Configuración → Usuarios → pestaña API.
• Puedes crear tantos como quieras y asignarles los mismos roles que a un usuario normal.
• Cada Usuario API tiene un token JWT que lo identifica ante la API.
• El token se muestra una sola vez al momento de crearlo: debes copiarlo y guardarlo de inmediato.
• Con este token tu sistema puede hacer llamadas autenticadas a la API.

Cómo crear un Usuario API

1. Ingresa a la app de Duemint.
2. Ve a Configuración → Usuarios → pestaña API.
3. Haz clic en Crear Usuario API.
4. Define un nombre y asigna los roles (ej: Tesorería, Payouts).
5. Guarda el usuario y copia el token JWT que se genera (se mostrará solo una vez).

Cómo usar el token

Incluye el JWT en cada request con el header estándar Authorization: Bearer.
También debes indicar el ID de compañía (X-Company-Id) para que la API sepa en qué tenant operar.

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-Company-Id: {COMPANY_ID}'

Llave pública (Próximamente)

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.