Notificaciones y suscripciones
La capacidad de Notificaciones y Suscripciones de Cobre permite a las organizaciones recibir actualizaciones en tiempo real sobre eventos clave de la plataforma a través de un mecanismo centralizado basado en webhooks. En lugar de depender de consultas periódicas o monitoreo manual, los clientes pueden construir operaciones que respondan inmediatamente a cambios en saldos, estado de pagos, contrapartes, reportes, flujos de evidencia y más.
Esto es importante porque mejora la velocidad operacional, precisión de conciliación y experiencia del cliente—especialmente a escala y a través de múltiples rieles de pago y mercados.
1. Lo que Cobre permite con Notificaciones y Suscripciones#
Con Notificaciones y Suscripciones, Cobre permite a los clientes:Suscribirse a eventos de la plataforma a través de múltiples productos y servicios (Cuentas, Movimientos de Dinero, Transfronterizo, Masivo, Reportes, Evidencia, Claves, Contrapartes, etc.)
Recibir notificaciones webhook en tiempo real cada vez que ocurran eventos seleccionados
Construir automatizaciones basadas en eventos para conciliación, alertas de riesgo, notificaciones a clientes y flujos de trabajo operacionales
Estandarizar el consumo de eventos usando un esquema de eventos consistente a través de todas las funciones suscritas
Mejorar la seguridad habilitando notificaciones firmadas que ayudan a verificar autenticidad e integridad
Aumentar la confiabilidad de entrega con un esquema de reintentos para fallas de entrega transitorias
Escalar integraciones de manera más predecible cambiando de "verificar estado" a "reaccionar a eventos"
2. Notificaciones y Suscripciones en el Modelo de Cobre#
Notificaciones y Suscripciones es una capa transversal que conecta los objetos operacionales de Cobre con los sistemas cliente:Cobre Balance genera eventos cuando los saldos son acreditados o debitados, habilitando monitoreo de liquidez en tiempo real y disparadores de conciliación.
Movimientos de Dinero y flujos relacionados (incluyendo Masivo y Transfronterizo) generan eventos que reflejan cambios de ciclo de vida y estado operacional—ayudando a los clientes a reaccionar a la finalización de pagos, rechazo o transiciones de estado interno.
Transacciones pueden reflejarse a través de cargas útiles de eventos y usarse para sincronizar libros contables financieros o alimentar pipelines de reportes.
Reportes y Solicitudes de Evidencia pueden emitir eventos que permiten a los equipos automatizar procesos de cumplimiento y conciliación.
3. Capacidades Clave / Opciones#
3.1 Suscripción de Eventos Centralizada a través de Productos#
Cobre proporciona un mecanismo unificado para suscribirse a eventos a través de dominios de la plataforma, incluyendo:Movimientos de Dinero Masivos
Movimientos de Dinero Transfronterizos
3.2 Notificaciones Webhook con un Esquema de Eventos Estándar#
Todas las notificaciones siguen un formato de evento consistente, típicamente incluyendo:Un identificador de evento
Una clave de evento (qué pasó)
Una carga útil de contenido específico del evento
3.3 Notificaciones Firmadas para Integridad y Autenticidad#
Para clientes que requieren controles de seguridad más altos, Cobre soporta notificaciones firmadas, permitiendo a los receptores de webhook verificar que:La notificación es genuina
La carga útil no fue alterada en tránsito
3.4 Confiabilidad a través de Reintentos Automáticos#
Cobre aplica un esquema de reintentos para fallas de entrega causadas por problemas de conexión.
Los reintentos están diseñados para mejorar la resistencia mientras evitan duplicación innecesaria en casos donde los clientes rechazan intencionalmente las solicitudes (ej., respuestas 4xx).
3.5 Automatización Basada en Eventos a Escala#
Las notificaciones pueden usarse para disparar flujos de trabajo como:ejecuciones de conciliación
actualizaciones de estado de pago internas
acciones posteriores vinculadas a resultados de movimientos de dinero
4. Conceptos Centrales y Terminología#
Suscripción: Una configuración que define qué tipos de eventos quiere recibir un cliente y dónde deben ser entregados.
Evento: Una notificación estructurada que representa algo que ocurrió en la plataforma de Cobre (ej., saldo acreditado, pago actualizado).
Clave de Evento: El identificador que representa el tipo de evento (usado para clasificar notificaciones).
Webhook: El mecanismo de entrega usado para enviar notificaciones al sistema del cliente en tiempo real.
Notificación Firmada: Una notificación que incluye señales de verificación criptográfica para que el receptor pueda validar autenticidad e integridad.
Esquema de Reintentos: Intentos automáticos de reentrega para fallas elegibles (ej., errores de conexión).
5. Velocidad, Liquidación y Confiabilidad (si aplica)#
Las notificaciones están diseñadas para conciencia operacional casi en tiempo real, significando que los eventos se entregan cuando ocurren en lugar de estar disponibles solo a través de exportaciones programadas o verificaciones periódicas.La confiabilidad está soportada por:Reintentos automáticos para errores de conexión, mejorando el éxito de entrega cuando los sistemas experimentan caídas transitorias.
Notificaciones firmadas opcionales, que mejoran la confianza y auditabilidad permitiendo a los clientes validar la notificación.
Por ejemplo, un evento "cuenta acreditada" refleja un cambio de saldo registrado, mientras que un evento "estado de movimiento de dinero" refleja un estado de proceso.
6. Casos de Uso Empresariales Típicos#
Los casos de uso comunes incluyen:Disparadores de conciliación en tiempo real cuando los saldos cambian
Automatización de estado de pagos para soporte al cliente u operaciones de comerciantes
Monitoreo de fraude y riesgo basado en eventos relacionados con transacciones o contrapartes
Sincronización de libros contables internos usando cargas útiles de eventos como fuente de verdad
Alertas operacionales (ej., movimientos fallidos, cambios de estado de evidencia)
Orquestación de flujos de trabajo para programas de pagos masivos o transfronterizos
7. Transacciones, Reportes y Conciliación#
Notificaciones y Suscripciones mejora la conciliación haciendo que los eventos de Cobre estén disponibles cuando ocurren, habilitando:Sincronización inmediata de impactos de transacciones en libros contables internos
Captura automatizada de cambios de saldo para equipos de tesorería y finanzas
Manejo más rápido de excepciones cuando los movimientos fallan, son rechazados o requieren atención operacional
8. Gobernanza, Controles y Auditabilidad#
Notificaciones y Suscripciones soporta la gobernanza a través de:Trazabilidad: cada notificación incluye un identificador de evento y marca de tiempo, habilitando pistas de auditoría.
Controles de integridad: las notificaciones firmadas permiten a los clientes verificar autenticidad y detectar manipulación.
Resistencia operacional: el comportamiento de reintentos reduce el riesgo de perder eventos críticos durante breves interrupciones.
9. Notificaciones y Suscripciones vs Consultas / Verificaciones de Estado Periódicas#
| Dimensión | Notificaciones y Suscripciones | Consultas / Verificaciones Periódicas |
|---|
| Tiempo de actualización | Push en tiempo real | Retrasado, depende de la frecuencia |
| Carga de trabajo operacional | Menor (basado en eventos) | Mayor (consultas constantes) |
| Enfoque de confiabilidad | Reintentos para fallas elegibles | El cliente debe manejar reintentos y brechas |
| Opciones de seguridad | Notificaciones firmadas disponibles | Típicamente ninguna |
| Mejor para | Alto volumen, automatización, conciliación | Bajo volumen, flujos de trabajo simples |
Notificaciones y Suscripciones es usualmente preferido cuando los clientes necesitan operaciones en tiempo real, conciliación escalable y menor sobrecarga de integración.
10. Resumen — Lo que Cobre Entrega con Notificaciones y Suscripciones#
Cobre permite a los clientes: Suscribirse a eventos de la plataforma a través de líneas de producto clave
Recibir notificaciones webhook en tiempo real con un esquema estandarizado
Construir flujos de trabajo de automatización para conciliación, monitoreo y operaciones de pago
Mejorar la seguridad con validación de integridad de notificaciones firmadas
Aumentar la resistencia de entrega a través de un esquema de reintentos definidoAl convertir a Cobre en una plataforma basada en eventos, Notificaciones y Suscripciones ayuda a las empresas a operar pagos a escala con mayor visibilidad, reacciones más rápidas y mejor control financiero. Modified at 2026-02-03 02:05:10
