Descomposición de IBAN

Descripción general

La función de Descomposición de IBAN permite la extracción de un BIC (Código de Identificación Bancaria) de un IBAN (Número de Cuenta Bancaria Internacional). Esta funcionalidad es esencial para el proceso de Verificación del Beneficiario, ya que determina el enrutamiento correcto al servicio apropiado para verificar al beneficiario.

La deconstrucción del IBAN se realiza utilizando el CSM reachability service, la información detallada sobre esta funcionalidad está disponible aquí

Cómo Funciona

La función de Deconstrucción de IBAN funciona de la siguiente manera:

  1. El cliente envía una solicitud sin proporcionar un BIC.

  2. Se envía una solicitud a la CSM Reachability Service para descomponer el IBAN.

  3. El servicio devuelve el BIC.

  4. El BIC se utiliza para dirigir al servicio apropiado para realizar la verificación del beneficiario.

La integración con el servicio de Deconstrucción de IBAN se gestiona a través del Marco de Conectores, utilizando un HTTP conector. Más información sobre el HTTP el conector está disponible aquí.

Configuración

Las siguientes opciones de configuración están disponibles para la Descomposición de IBAN:

Property Grouping: ipf.csm-reachability-api.http.client

Key Description Default Value

ipf.csm-reachability-api.http.client.host

 
"localhost"

ipf.csm-reachability-api.http.client.port

 
"8080"

Property Grouping: ipf.csm-reachability-api.connector.iban-deconstruct

Key Description Default Value

ipf.csm-reachability-api.connector.iban-deconstruct.resiliency-settings.max-attempts

Determines the maximum number of retries to be made. Note that this includes the first failed attempt.

 
2

ipf.csm-reachability-api.connector.iban-deconstruct.resiliency-settings.minimum-number-of-calls

Determines the minimum number of calls (within a sliding window period) that need to be made before the circuit breaker can calculate the error rate to determine the transport health.

 
10

ipf.csm-reachability-api.connector.iban-deconstruct.resiliency-settings.retryable-status-codes

Retry if HTTP error code is in the list

 
[
    500,
    503
]

Manejo de Errores

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 BIC para el IBAN proporcionado. Esto puede suceder si el IBAN es válido, pero la institución financiera asociada no tiene un BIC registrado en el sistema. Mensaje de error:`BIC not found for IBAN {iban}`

400

Cuando hay un error del servicio de deconstrucción de IBAN. Esto puede ocurrir si el servicio devuelve una respuesta de error, como un 4xx o 5xx. HTTP código de estado. Mensaje de error:`Error received from deconstruct IBAN service for IBAN {iban}`

503

Cuando el servicio de deconstrucción de IBAN no está disponible. Esto puede suceder si hay problemas de red o si el servicio está inactivo. Mensaje de error:`Could not retrieve a BIC for IBAN {iban} because the deconstruct IBAN service is unavailable`

503