Documentation for a newer release is available. View Latest

CSM Participant

CSM Participant es una configuración dinámica utilizada para registrar la membresía/participación de entidades en un Agent. La configuración dinámica tiene una estructura genérica que carga la información de membresía proporcionada por los esquemas de la industria.

Los datos de la industria se cargan en la configuración dinámica CSM Participant a través de aplicaciones de ingesta de archivos proporcionadas por IPF. La implementación de ingesta proporciona el mapeo de atributos desde los archivos fuente de la industria hacia los atributos de registro de CSM Participant definidos por IPF.

Los registros de CSM Participant son utilizados por CSM Reachability para confirmar la participación de contrapartes para un CSM Agent dado y, por tanto, la reachability de las contrapartes a través del CSM Agent.

IPF soporta la siguiente ingesta de archivos de la industria en CSM Participants:

Sr. No. Payment Scheme Industry Data File Industry Source File Format File Type (Full / Delta)

1

RT1 SEPA INST

SCI Participant Routing Table

EBA

TXT

Full

2

RT1 SEPA INST

SCI Addressable PSP Routing Table

EBA

TXT

FULL

3

TIPS SEPA INST

TIPS Directory

EUROSYSTEM (CRDM)

XML

FULL, DELTA

4

STEP2 SEPA SCT

SCT Direct Participant Routing Table

EBA

TXT

FULL

5

STEP2 SEPA SCT

SCT Reachable BIC Routing Table

EBA

TXT

FULL

6

SIC, EuroSIC

Bank Master 3.0

SIX

JSON

FULL

7

STET

STET Agreement Export File

STET

XML

FULL

Es importante señalar que cada fuente de datos de la industria puede seguir un formato diferente. IPF define el mapeo de los atributos proporcionados por la industria hacia CSM Participant para garantizar que la comprobación de participación se realice de manera coherente en los distintos esquemas de la industria.

A medida que se soporten más esquemas en IPF, se implementará la ingesta de los archivos de membresía proporcionados por sus respectivos proveedores y se añadirán los detalles aquí.

Es posible que los clientes de IPF soliciten ampliar el soporte de ingesta de CSM Participant para un archivo de membresía de un esquema específico que no esté ya en la lista, lo cual podría introducirse sujeto a acuerdos de licencia.

También es posible que las implementaciones de cliente definan su propia ingesta de membresía personalizada para un direct account agent (no un esquema de compensación) y definan el mapeo hacia la configuración dinámica CSM Participant. Esta será una implementación específica del cliente usando IPF y no estará disponible como estándar en IPF Core.

IPF soporta ingestas de archivos FULL y DELTA para CSM Participants cuando así lo proporcionan las respectivas fuentes de la industria.

CSM Participant Dynamic Configuration Structure

La siguiente tabla proporciona información sobre los distintos atributos soportados en la configuración dinámica CSM Participant. Para más información sobre el formato y opcionalidad de los atributos, consulta las especificaciones de la DPS Setting management API para la configuración dinámica.

CSM Participant Directory property Description

csmAgentId

Identificador del CSM Agent. Este CSM Agent ID debe ser el mismo que el asignado en Agent Settings bajo Participation Details.

csmParticipantIdentifier

El identificador de la entidad participante en el CSM Agent. Este identificador puede ser de distintos tipos según los CSM Agents. La información sobre los identificadores utilizados por los Agents se registra en Agent Settings en la sección Participation Details.

participantName

Nombre de la entidad participante en el CSM Agent.

participantType

Tipo de participante, 'DIRECT' o 'INDIRECT'.

activeFromDate

La fecha a partir de la cual la entidad será/ha sido un participante activo del CSM Agent.

En algunos casos, una entidad puede tener dos registros en CSM Participants (p. ej., cuando un participante pasa de ser indirecto a directo). Ambos registros tendrán fechas de inicio de actividad separadas y las solicitudes de reachability elegirán el registro activo en el momento de la comprobación de reachability (o a la fecha indicada en la solicitud).

activeToDate

La fecha hasta la cual la entidad será participante del CSM Agent. La fecha se tiene en cuenta al realizar la comprobación de reachability para garantizar que las entidades cuya activeToDate esté en el pasado no se consideren alcanzables.

routingBIC

El routing BIC utilizado por la entidad. El routing BIC no se utiliza para fines de reachability, pero estará disponible en los registros de CSM Participant para que los flujos de implementación del cliente lo utilicen para enriquecer los pagos para el uso correcto del routing BIC.

En el caso de un participante indirecto, el routing BIC puede ser el BIC del participante directo relacionado.

paymentTypeAllowedList

Lista de tipos de pago permitidos. La información de tipos de pago permitidos no está disponible para todos los CSM Agents y se carga en los registros de CSM Participant cuando la proporciona la fuente de la industria (por ejemplo, en STEP2, la lista de tipos de pago puede incluir la suscripción AOS de los participantes).

domicileAddress

Dirección de domicilio del CSM Participant tal como la proporciona la fuente de la industria.

participantCity

Ciudad donde el participante está oficialmente registrado

postalCode

Código postal del participante, como lo proporciona la fuente de datos de la industria.

postalAddress

Dirección postal del participante, como lo proporciona la fuente de datos de la industria.

participantCountry

País donde el participante está oficialmente registrado

industryFields

Industry Fields es una colección de campos adicionales de los archivos de la industria que pueden cargarse en CSM Participant además de la definición estándar. Los Industry fields no se cargan para todas las fuentes y, cuando se cargan, seguirán un esquema separado para cada fuente según las definiciones de mapeo específicas de la fuente (solo soportado para cargas específicas de SIC).

rMessageOnly

Indicador que indica si el participante solo puede recibir mensajes R, 'true' o 'false'. Se asume false si el indicador no está poblado en un registro.

Setting Type

DPS v2 introdujo un nuevo atributo de Setting Type. Se utiliza para la generación de todos los endpoints de API para una configuración en particular. También se utiliza en la construcción index-config.<setting type>. SETTING_TYPE = "participant"

Searchable Fields

Los campos buscables para CSM Participant Directory son:

  • csmAgentId

  • csmParticipantIdentifier

  • participantName

  • participantCountry

  • participantCity

  • participantType

  • limitAmountCurrency

  • paymentTypeAllowed

Indexes

DPS v2 proporciona una opción para configurar índices para cada setting.

La propiedad anterior para los índices en Participant era dynamic-settings.default-index.participant. Esta propiedad se ha eliminado y debe usarse la nueva propiedad ipf.dps.mongodb.index-config.participant, que contiene todos los índices anteriores y puede sobrescribirse.

Los índices por defecto para CSM Participant Directory son:

ipf.dps.mongodb.index-config.participant {
    index-1 = ["status:ASC"]
    index-2 = ["processingEntity:ASC"]
    index-3 = ["values.payload.csmAgentId:ASC"]
    index-4 = ["values.payload.csmParticipantIdentifier:ASC"]
    index-5 = ["values.payload.participantName:ASC"]
    index-6 = ["values.payload.participantCity:ASC"]
    index-7 = ["values.payload.participantCountry:ASC"]
    index-8 = ["values.payload.participantType:ASC"]
    index-9 = ["values.payload.limits.limitType:ASC"]
    index-10 = ["values.payload.limits.amount.amountValue:ASC"]
    index-11 = ["values.payload.limits.amount.currency:ASC"]
    index-12 = ["values.payload.paymentTypeAllowedList:ASC"]
  }

Esto puede sobrescribirse o actualizarse. Solo ten en cuenta que cuando el campo está bajo payload, necesitas proporcionar un índice como: index-x = ["values.payload.fieldX:ASC"].

Notifications

DPS v2 puede proporcionar una notificación después de que se realice cierta operación CRUD sobre una setting. Existe una opción para habilitar notificaciones a nivel de setting. Las notificaciones están deshabilitadas por defecto:

ipf.csm-reachability.should-send-notification.participant-settings = false

History

Existe una opción para deshabilitar el histórico a nivel de setting. El histórico está habilitado por defecto:

ipf.csm-reachability.should-save-history.participant-settings = true

CSM Participant Directory Mappings

CSM Participants es una estructura de datos genérica utilizada para registrar membresías en una variedad de CSM Agents y fuentes de la industria correspondientes. Los datos proporcionados por cada fuente se mapean a la configuración dinámica genérica para que las comprobaciones de membresía se realicen de manera coherente para cada CSM Agent.

Las páginas siguientes proporcionan las definiciones de mapeo entre las fuentes de la industria soportadas en CSM Reachability.

La documentación no proporciona las especificaciones de los propios archivos de datos de la industria y solo se documentan las propiedades que se cargan en CSM Participant. Para especificaciones detalladas de los archivos de datos de la industria para diferentes fuentes, consulta la documentación proporcionada por la respectiva fuente de la industria del archivo.

Cuando un cliente necesita una carga personalizada de CSM Participant, se deberá definir un mapeo similar por los equipos de implementación del cliente e implementarlo para que el servicio CSM Reachability pueda realizar la comprobación de participación de forma coherente. Consulta la página Creating a Custom Settings Ingester para los pasos involucrados.