Documentation for a newer release is available. View Latest

1. /validate-csm-reachability

Validates the reachability for a counterparty against a specific CSM Agent.

Purpose

  1. In some cases, the client implementation flows or channels applications may have a preferred CSM Agent pre-defined (due to customer preference or organizational policies). In these cases, the reachability check for given counterparty may be needed against a specific CSM Agent rather than selecting a CSM Agent from pre-defined list on CS Agent Selection settings dynamic configuration.

  2. Validate CSM Reachability API allows this reachability check to be done for the counterparty against a specific CSM Agent for given transfer currency and optionally transfer amount.

  3. The reachability check is done against below criteria:

    1. Settlement - Can the provided transfer currency be settled with the specified CSM Agent?

    2. Participation - Is the counterparty and CSM Agent the same entities or is the counterparty a participant to the CSM Agent?

    3. Limits - Is the transfer amount within the specified limits? Few important points about limits criteria check:

      1. The limits criteria is applied only when the request specifies the transfer amount and limits with "limitDirection" of "OUTBOUND" apply when they are configured and applicable.

      2. The limits can be specified at different levels and all applicable limits are checked when limit criteria is applicable. Any limits if specified on dynamic configurations cannot be bypassed by the API and if the client implementations want the limits not to be applied, the limits will need to be removed or reachability checks performed without transfer amounts.

      3. Please refer Determining Applied Limits for more details on how the applied limits are determined during Reachability checks.

Usage

validate csm reachability usage.drawio

Request and Response

Please refer CSM Reachability Service API for the API specifications and example request and responses.

Reason Codes

Possible reason codes are. Please refer Reachability Reason Codes for details on reason codes and descriptions.

  1. IPFRCH001

  2. IPFRCH002

  3. IPFRCH003

  4. IPFRCH004

  5. IPFRCH005

  6. IPFRCH006

  7. IPFRCH007

  8. IPFRCH008

  9. IPFRCH012