Membresía del Esquema

Descripción general

La membresía en el esquema es un componente clave del Servicio de Solicitante de Verificación de Beneficiario (VoP) que permite al servicio interactuar con diferentes esquemas de pago. Cada esquema de pago requiere identificadores de membresía específicos para autenticar y dirigir las solicitudes de verificación.

Cómo Funciona

La funcionalidad de Membresía del Esquema permite al Servicio de Solicitud VoP:

  1. Mapee los nombres de los esquemas a los ID de membresía.

  2. Soporte diferentes identificadores de membresía para diferentes entidades de procesamiento dentro del mismo esquema.

  3. Dirija las solicitudes de verificación de rutas al esquema apropiado con el ID de membresía correcto.

Entidad de Procesamiento Predeterminada

Cada esquema necesita una entidad de procesamiento predeterminada, marcada con processing-entity-code = default. Esto asegura que si una solicitud no especifica una entidad de procesamiento, el sistema automáticamente recurre a este valor predeterminado.

Configuración

Este componente carga los identificadores de membresía del esquema desde el archivo de configuración bajo el ipf.verification-of-payee.requester ruta. Crea un mapping entre los nombres de los esquemas, los códigos de las entidades de procesamiento y los identificadores de membresía de los esquemas.

Ejemplo de Configuración

Los identificadores de membresía del esquema se configuran de la siguiente manera:

Property Grouping: ipf.verification-of-payee.requester

Key Description Example Value

ipf.verification-of-payee.requester.available-schemes

Currently only supported scheme is EPC. Note that a scheme can only be listed once in available-schemes. This configuration contains all the valid scheme/rvm combinations, including those schemes which have no associated rvm.

 
[
    {
        "rvm" : FPAD,
        "scheme" : "EPC"
    }

]

ipf.verification-of-payee.requester.scheme-processing-entities

Scheme membership id’s are configured per scheme and processing-entity-code. See Example Value for structure

 
[
    {
        "processing-entities" : [
            {
                "processing-entity-code" : "default",
                "scheme-membership-id" : "H2J2ZA0A"
            },
            {
                "processing-entity-code" : "001",
                "scheme-membership-id" : "ICONUK03XXX"
            }
        ],
        "scheme" : "EPC"
    }

]

Detalles Adicionales

Detalles adicionales de los campos debajo ipf.verification-of-payee.requester.available-schemes are below:

Nombre del Campo Descripción

scheme

El nombre del esquema soportado. Valor soportado:`EPC`(Default)

rvm

El nombre del rvm soportado. Valor soportado:`FPAD`(Predeterminado)

Las propiedades de configuración anteriores permiten a los clientes especificar sus propios esquemas disponibles. Pero si los clientes desean utilizar los valores predeterminados especificados anteriormente, la configuración bajo ipf.verification-of-payee.requester.available-schemes puede omitirse por completo y se aplicarán los valores predeterminados.

Detalles adicionales de los campos debajo ipf.verification-of-payee.requester.scheme-processing-entities are below:

Nombre del Campo Descripción

scheme

El esquema para el cual la entidad de procesamiento debe el ID de membresía del esquema.mapping es aplicable. Valor soportado:`EPC`

processing-entities

Una lista de ID de membresía de entidad/proceso mappings para el esquema

processing-entities.processing-entity-code

El código de la entidad procesadora, esto además de scheme se utiliza para buscar el scheme-membership-id

processing-entities.scheme-membership-id

El ID de membresía que debe utilizar para el esquema y la entidad de procesamiento. En el mensaje enviado al esquema, esto representa el BIC del remitente/agente solicitante.

Manejo de Errores

Errores de Inicio

La membresía del esquema realiza validaciones de inicio y adopta una estrategia de fallo rápido que detiene el inicio de la aplicación si alguna de las siguientes validaciones de configuración falla:

  • Valida que cada esquema tenga al menos una entidad de procesamiento.

  • Asegura que cada esquema tenga una entidad de procesamiento predeterminada (processing-entity-code = default)

  • Valida que no existan esquemas y entidades de procesamiento duplicados.

  • Valida que solo se definan esquemas compatibles en la configuración.

  • Valida que solo se definan RVM compatibles en la configuración.

  • Valida que ipf.verification-of-payee.requester.available-schemes contiene valores válidos para scheme(at least one scheme debe ser definido)

  • Valida que ipf.verification-of-payee.requester.scheme-processing-entities contiene valores válidos para scheme(at least one scheme debe ser definido)

  • Valida que ipf.verification-of-payee.requester.responder-scheme es un esquema válido

Errores de Ejecución

Los siguientes errores pueden ocurrir en tiempo de ejecución. Cuando ocurre un error, el servicio responde con el correspondiente HTTP código de error, como se detalla en la tabla a continuación.

Error HTTP Código de retorno

Cuando no se puede encontrar un ID de membresía de esquema para un nombre de esquema y una entidad de procesamiento dados. Esto ocurre típicamente cuando una solicitud especifica una combinación de esquema y entidad de procesamiento que no está definida en la configuración. Mensaje de error:`Selected scheme '{scheme}' with processing entity '{processingEntity}' not found in config`

500

Cuando no se puede encontrar un adaptador para un esquema especificado. Esto ocurre típicamente cuando el sistema está configurado para utilizar un esquema que no tiene una implementación de adaptador correspondiente. Mensaje de error:`No scheme adapter was found for scheme: {scheme}`

500