Configuración de Procesamiento Personalizado

Configuración de Procesamiento Personalizado (CPS) es un servicio de configuración dinámica extensible dentro de IPF que proporciona la capacidad de configurar custom configuraciones con tipos de datos flexibles a nivel de la Entidad de Procesamiento. A diferencia de las categorías de configuración predefinidas, CPS permite a las implementaciones de los clientes definir sus propias claves de configuración con valores asociados de varios tipos, ofreciendo la máxima flexibilidad para los requisitos específicos de la implementación.

CPS aprovecha el patrón de diseño IPF conocido como " Dynamic Processing Settings " (DPS v2) para gestionar configuraciones dinámicas específicas del cliente customization propósitos sin requerir cambios en el modelo de dominio central.

1. IPF - Descripción general de la configuración de procesamiento personalizado

El servicio de Configuración de Procesamiento Personalizado ofrece las siguientes características para permitir una gestión de configuración flexible. Estas se documentan en las secciones que siguen.

  1. Tipos de Configuración Flexibles- Soporte para múltiples tipos de valor, incluyendo configuraciones de Booleano, Cadena, Número, Arreglo de Cadenas y Arreglo de Números, permitiendo diversas necesidades de configuración.

  2. Configuración de Entidad de Procesamiento- La configuración se limita al nivel de la Entidad de Procesamiento, lo que permite configuraciones específicas de la entidad.customizations y configuraciones.

  3. Dinámico Setting Management- Operaciones CRUD completas a través de estandarizado DPS v2 API puntos finales para crear, leer, actualizar y eliminar custom ajustes.

  4. Configuración Buscable- Configure los ajustes de consulta utilizando campos buscables, incluyendo estado, entidadDeProcesamiento, nombre De Configuración y categoría De Configuración para una recuperación eficiente.

  5. Personalizado Kafka Notifications- Event-notificaciones impulsadas a través de Kafka para todas las operaciones CRUD, permitiendo que los sistemas descendentes reaccionen a los cambios de configuración en tiempo real.

  6. Estructura Flexible de Clave-Valor- Las implementaciones de los clientes definen su propio custom configuración de claves sin requerir cambios en el esquema de la plataforma central.

Junto con las características de configuración, el servicio proporciona las siguientes capacidades de apoyo:

  1. Modelo de Notificación Personalizada- Implementa CpsCrudNotification con una estructura de carga útil aplanada para facilitar el consumo por parte de sistemas posteriores. Consulte Notificaciones.

  2. Seguimiento de Historial Configurable- Seguimiento histórico opcional de los cambios de configuración con control por configuración sobre la retención de historial.

  3. Índices optimizados- Preconfigurado MongoDB índices para consultas eficientes sobre los campos de estado, processingEntity, settingName y settingCategory.

Consulte la sección de Características para comprender las capacidades completas de la Configuración de Procesamiento Personalizado y cómo se integran con sus flujos de trabajo de procesamiento de pagos.

2. Arquitectura de Configuración de Procesamiento Personalizado

La arquitectura del servicio CPS se integra sin problemas con el IPF. Dynamic Processing Settings marco mientras proporciona custom extensiones para el manejo de notificaciones y la gestión de tipos de valor.

Componentes arquitectónicos clave:

  • Capa de Dominio- Configuración del modelo con tipos de valor polimórficos que admiten variantes de Booleano, Cadena, Número y Arreglo.

  • Capa de Servicio- Lógica empresarial para establecer la validación, persistencia y envío de notificaciones.

  • API Capa- REST puntos finales que siguen DPS convenciones v2 para integración estandarizada

  • Capa de Notificación- Personalizado Kafka-servicio de notificación basado en el envío CpsCrudNotification mensajes

  • Capa de Consulta- Campos buscables e índices optimizados para una recuperación eficiente de configuraciones

3. ¿Cómo utilizar esta documentación?

La documentación está estructurada en diferentes secciones:

  1. Características- Descripción general y especificación de las capacidades de Configuración de Procesamiento Personalizado, incluyendo tipos de valor, campos buscables y mecanismos de notificación. Consulte Características.

  2. Introducción- Pasos prácticos para integrar y utilizar el servicio de Configuración de Procesamiento Personalizado, incluyendo API integración y configuración. Consulte Introducción.

  3. API Referencia- Completo OpenAPI especificación para todos los puntos finales de gestión de configuraciones. Consulte Referencia de API.

Revise las secciones en el orden proporcionado para obtener una comprensión completa de la arquitectura del servicio, las capacidades y los patrones de integración.