6. /agentes-de-liquidación
Propósito
CSM Reachability service utiliza múltiples estructuras de datos que son compatibles con " Dynamic Processing Settings ". Las estructuras de datos utilizan DPS setting management API s que permiten que los registros sean creados / actualizados / eliminados dinámicamente. La implementación del cliente payment flows puede usar el setting management API s, sin embargo, esto expone los flujos al riesgo de que las definiciones de la estructura de datos cambien, ya que los atributos devueltos pueden cambiar como resultado.
Se propone, por lo tanto, que un 'Dominio API’s están disponibles para que los clientes implementen y recuperen configuraciones dinámicas relacionadas. Los candidatos para el 'dominio APIs Son configuraciones relacionadas con el Agente y configuraciones relacionadas con la entidad de procesamiento.
El dominio API/settlement-agents pueden ser utilizados por las implementaciones de los clientes para recuperar detalles del agente y de los ajustes de compensación y liquidación asociados.
Uso
El dominio API de /agentes-de-liquidación puede ser utilizado por la implementación del cliente payment flows para recuperar los aspectos a continuación de las configuraciones dinámicas relacionadas con un agente. (Un agente es una parte con la que la entidad de procesamiento mantiene una relación de liquidación).
-
Configuración del Agente
-
Configuración de Liquidación de Agentes
-
Configuración de Agente de Liquidación
Solicitud de Entrada
| Nivel | Atributo de Entrada | Opcionalidad | Descripción |
|---|---|---|---|
1 |
ProcessingEntity |
M |
La Entidad de Procesamiento para la cual se requiere la información del agente. |
1 |
IdentificadorDelAgente |
M |
Un identificador que identifica al agente de la entidad de procesamiento. |
1 |
TipoDeIdentificadorDeAgente |
M |
El tipo de identificador que se especifica en la solicitud en el campo "AgentIdentifier". A continuación, se presentan los tipos de identificadores admitidos. Los identificadores de agentes admitidos son BIC, NCC, LEI y AgentUniqueId. |
1 |
AgentIdentifierSubType |
C |
El sub-tipo del identificador proporcionado. BIC: accountIssuingBIC, schemeMembershipBIC NCC: Los enumerados de subtipo están alineados a ISO20022 códigos especificados. |
1 |
Agente País |
C |
Código de país de 2 caracteres del agente. Condicionalmente obligatorio cuando el TipoDeIdentificador es LEI. |
1 |
Incluir Configuración De Liquidación |
O |
El valor predeterminado se considera 'Falso' si no se especifica. Cuando se establece en Verdadero, se devolverá el registro de Configuraciones de Liquidación de Agentes para el agente especificado y la moneda de transferencia, si está configurada. |
2 |
+TransferirMoneda |
C |
Código de moneda de 3 caracteres de la moneda de transferencia del pago. Condicionalmente obligatorio cuando 'IncludeSettlementSettings' está establecido en TRUE. |
2 |
+Dirección De Transferencia |
C |
Condicionalmente obligatorio cuando 'IncludeSettlementSettings' está configurado en TRUE. La dirección de la liquidación desde el punto de vista de la entidad de procesamiento debe ser especificada. |
1 |
Incluir Configuración De Compensación |
O |
El valor predeterminado se considera 'Falso'. Cuando se establece en Verdadero, se devolverá el registro de Configuraciones de Despeje de Agente para el agente especificado, si está configurado. |
Respuesta
| Nivel | Atributo | Opcionalidad | Descripción |
|---|---|---|---|
1 |
Configuración del Agente |
M |
El registro de la configuración dinámica de Ajustes del Agente se devuelve si se encuentra el Agente con el AgentIdentifier coincidente en la entrada. |
1 |
Configuración de Liquidación de Agentes |
O |
El registro de la configuración dinámica de Ajuste de Agente se devuelve si se solicita y si se encuentra el registro con la moneda de transferencia coincidente en la entrada. |
1 |
Agente de Liquidación |
O |
El registro de la configuración dinámica de Agente Clearing se devuelve si se solicita y si se encuentra el registro con el AgentIdentifier coincidente en la entrada. |
- IMPORTANTE
-
-
Se devuelven las configuraciones de liquidación con la dirección de transferencia que coincide con la dirección de transferencia de entrada o con la dirección de transferencia de "Bidireccional", si están configuradas.
-
Los ajustes de liquidación de agentes pueden tener configuradas las siguientes categorías de límite:
-
Límites de Agente .Custom Límites de Participantes
-
Límites del País del Participante
-
Los límites pueden tener una dirección de transferencia de "Entrante" o "Saliente".
-
Los valores límite en la Configuración de Liquidación del Agente se devuelven con la dirección de transferencia correspondiente en la entrada, si está configurada. (Los límites de entrada se devuelven cuando la dirección de transferencia de entrada es "Entrada" y los límites de salida se devuelven cuando la dirección de transferencia de entrada es "Salida")
-
Refiera detalladamente API especificaciones aquí Integración.