Aprobación de Movimientos de Dinero
checker_approval = true, Cobre establece el estado del Money Movement en pending_approval. En ese momento, los fondos se bloquean en la cuenta de origen mediante una transacción de débito. Una vez que el flujo de aprobación externo del cliente llega a una decisión, dicha decisión se envía de vuelta a Cobre para que el Money Movement pueda continuar procesándose o ser cancelado.Cómo funcionan las Aprobaciones de Money Movement
checker_approval durante su creación. Una vez enviado a aprobación, la decisión de aprobación determina si el Money Movement puede procesarse o debe cancelarse. El objeto de aprobación incluye tres conceptos clave: la decisión, una descripción y uno o más aprobadores para trazabilidad. (Aprobar un Movimiento de Dinero)Resultados de la aprobación
| Resultado | Qué sucede |
|---|---|
| Aprobado | El Money Movement puede continuar su procesamiento. |
| Denegado | El Money Movement pasa a un estado cancelado. |
| Pendiente | El Money Movement permanece a la espera de una decisión de aprobación. |
Ciclo de vida de la aprobación
1. Crear el Money Movement con aprobación requerida
checker_approval = true.pending_approval.checker_approval y mm_approval_id, que permiten al cliente identificar si la aprobación está habilitada y hacer seguimiento del objeto de aprobación asociado. (Crear un Movimiento de Dinero)2. Ejecutar el flujo de aprobación externo del cliente
3. Enviar la decisión a Cobre
4. Cobre procesa o cancela el Money Movement
Comportamiento funcional
Los fondos se bloquean mientras la aprobación está pendiente
checker_approval = true, Cobre bloquea los fondos en la cuenta de origen con una transacción de débito mientras el Money Movement está en pending_approval.La aprobación es externa, la ejecución la garantiza Cobre
La aprobación solo puede ocurrir una vez
Conceptos del objeto de Aprobación
| Concepto | Descripción |
|---|---|
| Money Movement | La instrucción de pago que espera aprobación. |
| ID de Aprobación | El objeto de aprobación asociado al Money Movement. |
| Decisión | La instrucción final: aprobar o denegar. |
| Descripción | Contexto que explica por qué se tomó la decisión. |
| Aprobadores | Personas o sistemas responsables de la decisión de aprobación. |
| Estado | El estado de decisión actual del objeto de aprobación. |
Acciones que se pueden realizar sobre las Aprobaciones de Money Movement
✅ Decisión
🔍 Consulta
Descripción: Enviar la decisión de aprobación para un Money Movement que está en espera en
Qué esperar después de la acción: Si la decisión es aprobada, el Money Movement continúa su procesamiento. Si la decisión es denegada, el Money Movement se cancela.
📘 Más información:
pending_approval.Qué esperar después de la acción: Si la decisión es aprobada, el Money Movement continúa su procesamiento. Si la decisión es denegada, el Money Movement se cancela.
📘 Más información:
Cómo comenzar
Antes de usar esta API
Antes de usar las Aprobaciones de Money Movement
Define tu flujo de aprobación fuera de Cobre
Las Aprobaciones de Money Movement están diseñadas para clientes que quieren ejecutar su propio proceso de aprobación fuera de Cobre, como en un ERP, sistema de tesorería, herramienta de back-office o flujo de trabajo interno de Maker-Checker.Cobre retendrá el Money Movement y aplicará la decisión final, pero el cliente es responsable de definir quién aprueba, cuándo se requiere aprobación y qué reglas de negocio aplican.
Asegúrate de que la cuenta de origen tenga fondos suficientes
Cuando un Money Movement se crea con Asegúrate de que la cuenta de origen tenga fondos disponibles suficientes antes de crear el Money Movement.
checker_approval = true, Cobre establece el estado del Money Movement en pending_approval y bloquea los fondos en la cuenta de origen mediante una transacción de débito.Crea el Money Movement con aprobación requerida
Para enviar un Money Movement a aprobación, la solicitud debe incluir Una vez creado, el Money Movement no continuará su procesamiento hasta que se proporcione una decisión.
checker_approval = true.Almacena la referencia de la Aprobación del Money Movement
Una vez creado el movimiento de dinero, guarde la referencia de aprobación asociada.Esta referencia es necesaria para enviar la decisión final de aprobación o denegación una vez completado el flujo de aprobación externo.
Captura la información del aprobador para auditabilidad
La decisión de aprobación debe incluir información clara sobre el aprobador o los aprobadores involucrados en la decisión.Esto ayuda a mantener la trazabilidad para auditorías, controles internos, revisiones de cumplimiento e investigaciones operativas.
Envía la decisión final de aprobación a Cobre
Una vez que tu flujo externo llegue a una decisión, envía el resultado a Cobre.Si la decisión es aprobada, el Money Movement continúa su procesamiento. Si la decisión es denegada, el Money Movement se cancela.
Implementa Webhooks o reportes para monitorear el estado final
Después de enviar la decisión de aprobación, el Money Movement puede continuar a través de estados de procesamiento adicionales antes de alcanzar un resultado final.Recomendamos ampliamente implementar Webhooks o usar reportes de Money Movement para monitorear si el pago se completó, fue rechazado, falló o fue cancelado. Consulta Notificaciones y Suscripciones para más detalles.
Qué esperar después de usar esta API
El Money Movement permanece pendiente hasta que se proporcione una decisión
Cuando un Money Movement se crea con El pago no continuará su procesamiento mientras esté a la espera de una decisión.
checker_approval = true, permanecerá en pending_approval hasta que se envíe a Cobre una decisión de aprobación o denegación.Los fondos se bloquean mientras la aprobación está pendiente
Cobre bloquea los fondos en la cuenta de origen mediante una transacción de débito cuando el Money Movement entra en Esto garantiza que los fondos permanezcan reservados para el pago mientras se completa el flujo de aprobación externo.
pending_approval.Un Money Movement aprobado continúa su procesamiento
Si la decisión de aprobación es aprobada, el Money Movement continúa a través del ciclo de vida de procesamiento estándar.Después de la aprobación, el pago puede pasar por estados adicionales antes de alcanzar un resultado final como completado, rechazado o fallido.
Un Money Movement denegado se cancela
Si la decisión de aprobación es denegada, el Money Movement se cancela y no será procesado.El cliente debe actualizar su sistema interno en consecuencia, usando la denegación como la decisión de negocio final para ese pago.
La decisión de aprobación solo puede enviarse una vez
Una Aprobación de Money Movement solo puede recibir una decisión final.Una vez aprobada o denegada, la aprobación no puede modificarse ni volver a enviarse, lo que ayuda a preservar un registro de auditoría limpio.
Monitorea el estado final del Money Movement
Después de enviar la decisión, continúa monitoreando el Money Movement hasta que alcance un estado final.Recomendamos ampliamente usar Webhooks o reportes de Money Movement para monitorear si el pago se completó, fue rechazado, falló o fue cancelado. Consulta Notificaciones y Suscripciones para más detalles.
Reconcilia los datos de aprobación, movimiento y transacción
Para la reconciliación, usa la decisión de aprobación junto con el estado del Money Movement, la transacción de débito de la cuenta de origen y el resultado final del pago.Esto brinda a los equipos de finanzas y operaciones un registro de auditoría completo desde la creación del pago, hasta la decisión de aprobación, hasta el resultado final de ejecución.
Modified at 2026-07-02 17:17:19