Documentation for a newer release is available. View Latest

2. /select-csm-agent

Selecciona un CSM Agent a través del cual la contraparte es reachable para los datos del pago proporcionados. Usa las preferencias definidas por el cliente en la configuración dinámica de CS Agent Selection Settings para devolver un CSM Agent preferido y reachable para el pago.

Purpose

  1. Cuando uno o más CSM Agents son aplicables para un Payment Type, Service Level y Transfer Currencies dados, las implementaciones cliente pueden establecer la preferencia de qué CSM Agent debe seleccionarse mediante la configuración dinámica de Processing Data: CS Agent Selection Settings.

  2. Los Payment Types y Service Levels son valores específicos de la implementación cliente y deben definirse fuera del contexto de CSM Reachability, ya que pueden variar de un cliente a otro e incluso entre Processing Entities. Los Payment Types y Service Levels se establecen en CS Agent Selection Settings para asegurar que se seleccione el CSM Agent correcto para la comprobación de reachability.

  3. La API select-csm-agent comprueba la reachability de todos los CSM Agents especificados en CS Agent Selection Settings (que coincidan con los criterios de entrada) y devuelve el "Highest Order Reachable CSM". Este es el primer CSM Agent en CS Agent Selection Settings a través del cual se determina que la contraparte es reachable.

  4. La API también puede devolver CSM Data ampliado (como Agent Settings, Agent Clearing y Agent Settlement Settings y el registro de CSM Participant) para que los flujos de procesamiento de pagos puedan usar los datos para el enriquecimiento del pago.

  5. Junto con "HighestOrderReachableCSM", cuando se solicita, la API también puede devolver resultados de reachability para todos los CSM Agents especificados en CS Agent Selection Settings que coincidan con los criterios de entrada (independientemente de que la contraparte sea reachable a través del CSM Agent o no). Esta información puede ser útil cuando no se encuentra ningún CSM Agent reachable, de modo que se pueda realizar una intervención manual usando el resultado de reachability devuelto para todos los CSM Agents coincidentes en CS Agent Selection Settings.

  6. SelectCSM Agent utiliza el comportamiento del servicio Validate CSM Reachability para comprobar la reachability de los Agents listados en Cs Agent Selection Settings. Para más detalles, consulta Validate CSM Reachability

Usage

select csm agent usage.drawio

Request and Response

Consulta CSM Reachability Service API para las especificaciones del API y ejemplos de request y responses.

Dynamic Configurations

La API necesita que se configuren las siguientes configuraciones dinámicas:

  1. Processing Data:

    1. Processing Entity (Mandatory)

    2. CS Agent Selection Settings (Mandatory)

    3. Agent Settings (Mandatory)

    4. Agent Settlement Settings (Mandatory)

    5. Agent Clearing Settings (Optional - Needed if Clearing Settings are required in the response following selection of a CSM Agent for payment processing)

  2. Industry Data:

    1. CSM Participant (Optional - Needed if Agents involved have participants)

    2. Party Entity Directory (Optional - Needed if reachability checks are required using identifiers other than those used on Intra Entity Parties list)

    3. IBAN Plus Directory (Optional - Needed if IBAN use is required on Payment flows)

Reason Codes

Posibles reason codes. Consulta Reachability Reason Codes para detalles de los reason codes y sus descripciones.

  1. IPFRCH001

  2. IPFRCH002

  3. IPFRCH003

  4. IPFRCH004

  5. IPFRCH005

  6. IPFRCH006

  7. IPFRCH007

  8. IPFRCH008

  9. IPFRCH009