Payments out

En Duemint, los Payments out (o pagos salientes) permiten enviar fondos desde tu billetera Duemint hacia proveedores, colaboradores o cuentas propias.
Estos pagos pueden integrarse fácilmente con tus sistemas internos, de forma que todo el ciclo —desde la creación del pago hasta su firma y ejecución— se mantenga sincronizado con tus procesos operativos.

El módulo está diseñado para ofrecer una experiencia segura, trazable y automatizable, sin perder el control de aprobación y visibilidad que ofrece la app de Duemint.

🧭

En pocas palabras: los pagos salen desde tu billetera Duemint y pueden integrarse con tus flujos internos para que los procesos financieros, operativos y de aprobación trabajen en conjunto.

Cómo funciona

En Duemint, todos los pagos salientes se realizan desde una billetera de empresa, que actúa como el origen de los fondos.

A través de la API puedes enviar dinero a distintos destinatarios de manera automatizada y conectada a tus sistemas.

El flujo técnico se basa en un modelo único llamado Aggregated, que simplifica la operación combinando en una sola solicitud la creación del pago y del destinatario.

Este modelo permite cubrir todos los casos posibles de forma flexible:

Si el destinatario no existe, la API lo crea automáticamente.
Si el destinatario ya existe, se usa su registro actual.

📦

Aggregated: es el modelo principal de pagos en Duemint. Te permite crear el destinatario y el pago en una sola solicitud (POST /payments-out/aggregated), simplificando la integración sin perder el control de firmas y aprobaciones.

Firmar

Todos los pagos salientes y destinatarios nuevos con pagos asociados deben ser firmados antes de ejecutarse.

En Duemint existen dos formas de hacerlo:

Firma desde la app de Duemint

Puedes aprobar pagos directamente desde la aplicación web siguiendo estos pasos:

Ingresa a tu cuenta en Duemint.
Verás un banner indicando que tienes firmas pendientes.
Se abrirá un panel lateral donde podrás seleccionar los movimientos a firmar.
Haz clic en “Firmar”. Se te pedirá un código que puedes elegir si llega a tu teléfono o correo.
Ingresa el código recibido y confirma la firma.

🔒

Importante: Solo las personas configuradas como firmantes pueden autorizar pagos salientes. Asegúrate de tener tus firmas configuradas y la documentación de tu empresa completa antes de ejecutar pagos.

Firma con llave pública (PRONTO)

En una próxima versión podrás firmar pagos directamente desde tus integraciones, incluyendo un header con tu llave pública en la solicitud.

Esto permitirá automatizar la firma sin necesidad de ingresar manualmente a la app.

🔐

Próximamente: podrás registrar tu llave pública en la plataforma y firmar transacciones de forma automática desde tus integraciones.

Pasos para crear un pago Single

🔑 Antes de comenzar: revisa la Guía de Autenticación →

Obtener el ID de la billetera origen
- Usa GET /wallets para listar tus billeteras disponibles y copia el walletId desde la que deseas pagar.
Crear el pago agregado
- Envía una solicitud a POST /payments-out/single con:
  - totalAmount: monto a transferir.
  - walletId: ID de la billetera origen.
  - destination: datos del destinatario (nombre, cuenta bancaria, RUT, etc.).
    Si el destinatario no existe, se creará automáticamente.
Recibir notificación del resultado
- Si estás suscrito al webhook payment-updated, recibirás la información del pago junto con su estado (pending_authorization, processing, succeeded, etc.).
- En caso de que prefieras no utilizar el webhook, también puedes obtener esta información realizando una llamada al endpoint GET /payments/{payment-id}.

Diagrama explicativo

Estados principales de un Payment Out

Estado	Descripción
`creating`	El pago está siendo creado en la plataforma.
`pending_authorization`	El pago (y destinatario, si aplica) está pendiente de firma o autorización.
`programmed`	El pago fue programado para una fecha futura.
`expired`	El pago expiró antes de ser autorizado o procesado.
`pending`	El pago está pendiente de procesamiento por parte del sistema o banco.
`processing`	El pago fue enviado al banco y está en curso.
`in_transit`	El pago fue enviado al banco y se encuentra en tránsito para confirmación.
`confirmed`	El banco confirmó la recepción o validación inicial del pago.
`cancelled`	El pago fue cancelado por el sistema antes de completarse.
`failed`	El pago no pudo completarse debido a un error o rechazo bancario.
`paid`	El pago fue completado correctamente y los fondos se transfirieron.
`rejected`	El pago fue rechazado por un firmante.
`refunded`	El pago fue devuelto con éxito al origen (reembolso confirmado).
`refunding`	El proceso de devolución de fondos está en curso.
`refund_failed`	El intento de devolución del pago falló.

💡 Estos estados aplican a los pagos creados mediante la API de Duemint y reflejan el ciclo completo: creación, firma, ejecución, conciliación y reembolso.