Filtrado por país

Descripción general

El filtrado por país de respuesta es una función configurable que permite que una Solicitud de Verificación de Beneficiario (VoP) sea rechazada ya sea porque el país del Proveedor de Servicios de Pago (PSP) solicitante no es elegible para realizar la solicitud, o porque el país del PSP solicitante no está actualmente obligado a realizar la solicitud de acuerdo con el calendario regulatorio.

Cómo Funciona

  1. Confirme que el país del PSP Solicitante es elegible para realizar Solicitudes de VoP verificando si el Código de País del PSP Solicitante (tomado del BIC del PSP) está presente en una lista de Códigos de País elegibles.

  2. Si el código de país del PSP solicitante no está presente en la lista, entonces la solicitud de VoP es rechazada.

  3. Si la verificación del código de país es exitosa, confirme que el país del PSP solicitante está obligado a realizar solicitudes de VoP de acuerdo con la fecha regulatoria de VoP para ese país.

  4. Si la Fecha Regulatoria de VoP para ese país ha sido alcanzada o superada, o si el campo de Fecha Regulatoria está en blanco, entonces se permite la Solicitud de VoP.

  5. Si la Fecha Regulatoria de VoP para ese país está en el futuro, entonces la solicitud de VoP es rechazada.

Configuración

El filtrado por país está desactivado (se omitirá el filtrado por país) de forma predeterminada. Cuando esté habilitado, se le requerirá que proporcione una lista de países permitidos por esquema.

Ejemplo de Configuración

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

Key Description Example Value

ipf.verification-of-payee.responder.country-filtering.enabled

On/Off switch for country filtering

 
true

ipf.verification-of-payee.responder.scheme-allowed-countries

Allowed countries are configured per scheme

 
[
    {
        "allowed-countries" : [
            {
                "country-code" : "de",
                "regulatory-date" : "2025-09-17"
            },
            {
                "country-code" : "FR",
                "regulatory-date" : "2025-07-15"
            },
            {
                "country-code" : "Gb"
            }
        ],
        "regulatory-date-timezone" : "Europe/Belgrade",
        "scheme" : "EPC"
    }

]

Detalles Adicionales

Property Grouping: ipf.verification-of-payee.responder.country-filtering

Key Description Default Value

ipf.verification-of-payee.responder.country-filtering.enabled

On/Off switch for country filtering

 
false

Detalles adicionales de los países permitidos para el filtrado a continuación ipf.verification-of-payee.responder.scheme-allowed-countries are below:

Nombre del Campo Descripción

scheme

Esquema VoP

regulatory-date-timezone

Campo opcional para configurar la zona horaria de fecha y hora para calcular si la fecha regulatoria ha pasado. Si no está definido, se utiliza UTC por defecto. El valor debe ser un identificador de zona horaria válido de la Autoridad de Números Asignados de Internet (IANA) (por ejemplo, "Europe/Berlin").

allowed-countries[n].country-code

Código de país que debe ser permitido. Es un campo obligatorio y debe tener 2 caracteres alfabéticos en minúsculas o mayúsculas.

allowed-countries[n].regulatory-date

Fecha regulatoria que debe cumplirse para el país dado. El campo es opcional; si no se proporciona, se omitirá la verificación de la fecha regulatoria. El valor debe seguir "YYYY-MM-DD" formato.

Manejo de Errores

Errores de Inicio

El filtrado por país realiza validaciones de inicio en la configuración dada y fallará el inicio de la aplicación si no se cumple alguna de las siguientes condiciones:

  • El filtrado por país debe estar habilitado o deshabilitado en la ruta.ipf.verification-of-payee.responder.country-filtering.enabled

  • Si el filtrado por país está habilitado:

    • scheme-allowed-countries - no puede estar vacío

    • scheme - debe estar presente y ser un nombre de esquema válido (por ejemplo, EPC)

    • regulatory-date-timezone - si está configurado, debe ser un identificador de zona horaria válido de la Autoridad de Números Asignados de Internet (IANA) (por ejemplo, "Europe/Berlin").

    • country-code - se requiere y debe ser de 2 caracteres alfabéticos insensibles a mayúsculas.

    • regulatory-date - si está configurado, debe ser un formato de fecha válido "YYYY-MM-DD"(ej."2025-09-12")