PingAll

PingAll is a jXchange service designed to allow a consumer to take advantage of functionality related to the specific release installed at a Financial Institution (FI) site.

Message Flow

In jXchange, the PingAll service uses a typical exchange of MType messages to provide consumers the ability to take advantage of functionality related to the specific release installed at an FI.

Primary Request

The consumer forwards the PingAllRq_MType message to the service provider. The message contains the following simple element:

  • IncNonProdEnv
  • InstRtId
  • PingRq
  • PrvdFamName
  • SvcPrvdName

Primary Response

The service provider returns the PingAllRs_MType message to the consumer. The message contains PingAllArray_AType.

Ping All Behavior

The Ping All service behavior is as follows.

PingAll is an aggregate service, meaning that users can submit a single request to receive an array of all providers supported via jX at the specified financial institution.

The PingAll message response returns the Service Provider Version for each of the providers.

PingAllRq_MType

PingAllRq_MType is a message MType element.

This is a common ping request to all service providers for checking, testing, and keeping alive.

Simple Elements

The following simple elements are contained within this message.

IncNonProdEnv
Answers the question: should financial institutions' non-production environments be included in the response? Canonical values are:
  • True
  • False
InstRtId
The identification of the entity of the submitted message. A financial institution entity uses the routing transit or nine-digit number assigned to financial institutions for routing as assigned by the American Bankers Association. Any leading zeros must be provided for a complete routing and transit number. A non-financial institution entity should use a mutually agreed upon identification that must contain at least one non-integer character. The canonical value is JHA.

The element is required in all message requests.

PingRq
Generic text for the ping request.
PrvdFamName
The category or group that the event owner is associated with. Canonical values are:
  • Card Services
  • CkImg
  • Core
  • CrCardServices
  • DocImg
  • Fraud
  • HumanCapMgmt
  • JES
  • OLB
  • PltFm
  • TellerSys
  • Wires
  • VR
SvcPrvdName
The message service providers. Canonical values are:
  • 4Sight
  • AlrtCenter
  • Argo
  • BrdCst
  • CIF2020
  • CoreDir
  • Cruise
  • DirectLineIntlWires
  • DirectLineWires
  • EL
  • ENS
  • EPS
  • EWF
  • iPay
  • iTalk
  • jXchange
  • MFA
  • NetTeller
  • ODI
  • OnBoardDep
  • OnBoardLn
  • Passport
  • PmtProcSols
  • Silhouette
  • SilverLake
  • Synapsys
  • Synergy
  • TimeTrack
  • TP_FISTBS
  • TP_IMM
  • Vertex

PingAllRs_MType

PingAllRs_MType is a message MType element.

This is a common ping response to all service providers which echoes back the string sent in the PingAllRq_MType.

Contains:

  • PingAllArray_AType

PingAllArray_AType

PingAllArray_AType is an array AType element. This is an array of ping responses from service providers.

Contains:

  • PingAllInfoRec_CType
PingAllInfoRec_CType

PingAllInfoRec_CType is a complex CType element.

Simple Elements

The following simple elements are contained within this complex.

FinInstName
The depository financial institution name.
InstEnv
An identification provided by the consumer that defines the environment in which the institution is operating. Canonical values are:
  • Prod
InstRtId
The identification of the entity of the submitted message. A financial institution entity uses the routing transit or nine-digit number assigned to financial institutions for routing as assigned by the American Bankers Association. Any leading zeros must be provided for a complete routing and transit number. A non-financial institution entity should use a mutually agreed upon identification that must contain at least one non-integer character. The canonical value is JHA.

The element is required in all message requests.

PingRs
String echoed back from the PingRq. The element value contains Error when the PingRq to a service provider is not successful. Canonical values are:
  • Error
PrvdFamName
The category or group that the event owner is associated with. Canonical values are:
  • Card Services
  • CkImg
  • Core
  • CrCardServices
  • DocImg
  • Fraud
  • HumanCapMgmt
  • JES
  • OLB
  • PltFm
  • TellerSys
  • Wires
  • VR
SvcProdVer
The product version structure is representative of major version, minor version, and build number. The service provider version must be populated with a standard format: YYYY.Point_Release.Coompatibility_Patch

An example of a service provider version: 2016.01.07.

SvcPrvdName
The message service providers. Canonical values are:
  • 4Sight
  • AlrtCenter
  • Argo
  • BrdCst
  • CIF2020
  • CoreDir
  • Cruise
  • DirectLineIntlWires
  • DirectLineWires
  • EL
  • ENS
  • EPS
  • EWF
  • iPay
  • iTalk
  • jXchange
  • MFA
  • NetTeller
  • ODI
  • OnBoardDep
  • OnBoardLn
  • Passport
  • PmtProcSols
  • Silhouette
  • SilverLake
  • Synapsys
  • Synergy
  • TimeTrack
  • TP_FISTBS
  • TP_IMM
  • Vertex