Coincidencia de Nombres

Descripción general

La coincidencia de nombres se refiere a la forma en que el servicio de Respuesta de Verificación de Beneficiario (VoP) empareja nombres utilizando el Resolución de Identidad IPF servicio, que está en funcionamiento embedded en VoP Responder.

La lógica de coincidencia de nombres proporciona una forma de configurar los umbrales utilizados para la coincidencia de nombres en el servicio de Verificación de Beneficiario. Los umbrales determinan cuán estrechamente deben coincidir los nombres para ser considerados una coincidencia, una coincidencia cercana o ninguna coincidencia.

Cómo Funciona

La funcionalidad de Coincidencia de Nombres permite al servicio VoP Responder:

  1. Mapear entidades de procesamiento a diferentes tipos de cuenta y, en última instancia, a umbrales de puntuación.

  2. Mapee diferentes tipos de cuenta a los umbrales de puntuación.

  3. Envíe solicitudes de comparación de nombres para puntuación y reciba una respuesta puntuada.

  4. Determine un resultado de coincidencia basado en una puntuación proporcionada de los nombres. Esto podría ser sin coincidencias, coincidencia cercana o coincidencia.

  5. Al puntuar contra múltiples nombres, en el caso de cuentas conjuntas, el nombre que obtenga la puntuación más alta se utilizará para determinar el resultado del partido.

  6. Puntuación contra un Tipo de Nombre que podría ser TOTAL_ORGANIZACIÓN o INDIVIDUAL según lo definido en el API de Gestión de Cuentas. Proporcionando una mejor precisión dependiendo de si se trata de un nombre individual o corporativo.

Entidad de Procesamiento Predeterminada

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

Tipo de Cuenta Predeterminado

Cada esquema necesita un tipo de cuenta predeterminado, marcado con scorings.type = "default". Esto asegura que si una solicitud no especifica un tipo de cuenta, o si no coincide, el sistema automáticamente regresa a este valor predeterminado.

Configuración

VoP Responder requiere que se configure el umbral de puntuación antes de que se inicie la aplicación. Esta configuración se espera bajo el ipf.verification-of-payee.responder.name-match ruta.

Ejemplo de Configuración

Los umbrales de coincidencia de nombres se configuran de la siguiente manera:

Property Grouping: ipf.verification-of-payee.responder.name-match

Key Description Example Value

ipf.verification-of-payee.responder.name-match.thresholds

Thresholds are configured per processing entity

 
[
    {
        "processing-entity" : "default",
        "scorings" : [
            {
                "lowerbound" : 0.2,
                "type" : "default",
                "upperbound" : 0.4
            },
            {
                "lowerbound" : 0.5,
                "type" : "individual",
                "upperbound" : 0.7
            },
            {
                "lowerbound" : 0.8,
                "type" : "corporate",
                "upperbound" : 0.9
            }
        ]
    }
,
    {
        "processing-entity" : "processing entity A",
        "scorings" : [
            {
                "lowerbound" : 0.1,
                "type" : "default",
                "upperbound" : 0.3
            },
            {
                "lowerbound" : 0.4,
                "type" : "individual",
                "upperbound" : 0.6
            },
            {
                "lowerbound" : 0.8,
                "type" : "corporate",
                "upperbound" : 0.8
            }
        ]
    }

]

Detalles Adicionales

Detalles adicionales de los campos debajo ipf.verification-of-payee.responder.name-match.thresholds are below:

Nombre del Campo Descripción

processing-entity

La entidad de procesamiento a la que se aplica la lista de puntuaciones. A default se requiere una entidad de procesamiento cuando la respuesta de Gestión de Cuentas no contiene ninguna entidad de procesamiento, en cuyo caso se utilizará la entrada predeterminada. Este campo debe coincidir con lo que se devuelve en el API de Gestión de Cuentas campo processing Entity.

scorings

Una lista de puntuaciones para la entidad de procesamiento.

scorings.type

El tipo de cuenta al que se aplica esta puntuación. A default El tipo es requerido cuando la respuesta de Gestión de Cuentas no contiene tipo de cuenta, en cuyo caso se utilizará la entrada predeterminada. Esto debe coincidir con lo que se devuelve en el API de Gestión de Cuentas campo account Type.

scorings.lowerbound

El puntaje mínimo utilizado para determinar un resultado de no coincidencia o coincidencia cercana. Un puntaje inferior a este valor resultará en una no coincidencia. Un puntaje entre el scorings.lowerbound y scorings.upperbound resultará en una coincidencia cercana. El valor configurado debe ser del tipo Double y estar entre el rango de [0. 0, 1. 0].

scorings.upperbound

El puntaje máximo utilizado para determinar un resultado de coincidencia o coincidencia cercana. Un puntaje igual o superior a este valor resultará en una coincidencia. Un puntaje entre el scorings.lowerbound y scorings.upperbound resultará en una coincidencia cercana. El valor configurado debe ser del tipo Doble y estar entre el rango de [0. 0, 1. 0].
Si scorings.lowerbound se establece al mismo valor que scorings.upperbound esto elimina efectivamente las coincidencias cercanas, y usted solo puede obtener un resultado de coincidencia o de no coincidencia.

Ejemplos

A continuación se presentan algunos ejemplos de cómo funcionaría la puntuación dado el sample configuration arriba:

Entidad de Procesamiento

Tipo de Cuenta

Puntuación

Resultado

Descripción

-

corporativo

1. 0

Coincidir

Entidad de procesamiento predeterminada utilizada

entidad de procesamiento A

-

0. 9

Coincidir

Tipo de cuenta predeterminado utilizado

entidad de procesamiento A

individual

0. 8

Coincidir

No se utilizaron valores predeterminados.- cuenta individual

entidad de procesamiento A

corporativo

0. 8

Coincidir

No se utilizaron valores predeterminados.- cuenta corporativa

entidad de procesamiento A

individual

0. 5

Cierre de coincidencia

Resultado de coincidencia cercana

entidad de procesamiento A

corporativo

0. 4

No coincide

No hay resultado de coincidencia

"-"

Manejo de Errores

Errores de Inicio

La coincidencia de nombres realiza validaciones de inicio y adopta una estrategia de fallo rápido, deteniendo el inicio de la aplicación si alguna de las siguientes validaciones de configuración falla:

  • Configurar bajo la siguiente ruta ipf.verification-of-payee.responder.name-match.thresholds es requerido

  • A default se requiere una entidad de procesamiento

  • A default se requiere el tipo de umbral

  • No se permiten entidades de procesamiento duplicadas.

  • No se permiten tipos de puntuación duplicados.

  • Elementos de configuración scorings.lowerbound y scorings.upperbound debe estar entre [0. 0, 1. 0] y ser de tipo Double

  • Elemento de configuración scorings.lowerbound debe ser menor o igual a scorings.upperbound

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

Los errores encontrados al acceder a la Coincidencia de Nombres devolverán lo siguiente

Mensaje de error:`Could not retrieve a response because the Name Matching service is unavailable.`

500

Todos los demás errores relacionados con la coincidencia de nombres, por ejemplo, si una solicitud con un nameType no presente

Mensaje de error:`Unknown error occurred. Please check logs for more details`

500