Skip to main content

Class PayCenterFinancialInstitutionsAPIResponse


Response entity fields

ParameterTYPEDescription
FinancialInstitutionsArray of financial institutions.
PagingPagination object.

Provides pagination details for current request.
LinksLinks object.

Provides previous / next page links for current request.

Financial Institution object fields

ParameterTYPEDescription
FinancialInstitutionsIntegerUnique PayCenter financial institution id
ParticipantIdStringParticipant Id on the RTP network
FinancialInstitutionNamestringName of the financial institution
RoutingNumbersArray of routing numbers

Routing Number object fields

ParameterTYPEDescription
RoutingNumberStringRTN number.
ReceivingConnectionStringName of the connection where routing number associated with in RTP network.
isActiveBooleanStatus of the routing number.

(determined by the following conditions:-
  • Respective FI must be signed on RTP network (AND)
  • Respective connection must be available (AND)
  • RTP network must be available)
isJHABooleanDenotes whether the connection belongs to JHA.
ServicesArray of service object.

Enabled & disabled list of services for the current routing number.

Service object fields

ParameterTYPEDescription
TypeStringType of service.

(possible values are:- (any of the below)
  • CRDT
  • RFP
  • ACK
  • RMT
  • RFI
  • RFRF
  • RFPR
  • RFIR
  • RFRFR)
DescriptionStringDescription of the service
isEnabledBooleanDenotes whether the service is enable for the routing number

Paging object fields

ParameterTYPEDescription
ResultsIntegerNumber of financial institutions in the current page. (default number of items per page is: 50)
TotalIntegerTotal number of financial institutions in the Paycenter RTP network
NextOffsetIntegerCurrent page number
ParameterTYPEDescription
PrevStringPrevious page link
NextStringNext page link

Failure Response - Response entity and it's object fields

ParameterTYPEDescription
MessageStringType of error message. (Validation failed / execution failed).
CodeStringError code
DescriptionStringError description

Successful Response – 1 (all financial institutions details)

{
"FinancialInstitutions": [
{
"Id": integer,
"ParticipantId": string,
"FinancialInstitutionName": string,
"RoutingNumbers": [
{
"RoutingNumber": string,
"ReceivingConnection": string,
"isActive": boolean,
"isJHA": boolean,
"Services": [
{
"Type": string,
"Description": string,
"isEnabled": boolean
}
]
}
]
}
],
"Paging": {
"Results": integer,
"Total": integer,
"NextOffset": integer
},
"links": {
"prev": string,
"next": string
}
}

Successful Response – 2 (financial institution details by Routing Number or Participant Id)

{
"FinancialInstitutions": [
{
"Id": integer,
"ParticipantId": string,
"FinancialInstitutionName": string,
"RoutingNumbers": [
{
"RoutingNumber": string,
"ReceivingConnection": string,
"isActive": boolean,
"isJHA": boolean,
"Services": [
{
"Type": string,
"Description": string,
"isEnabled": boolean
}
]
}
]
}
],
"Paging": {
"Results": integer,
"Total": integer,
"NextOffset": integer
},
"links": {
"prev": string,
"next": string
}
}

Response 1: Sample

{
"FinancialInstitutions": [
{
"Id": 3,
"ParticipantId": "800000001T1",
"FinancialInstitutionName": "JHA Episys Certification CU ",
"RoutingNumbers": [
{
"RoutingNumber": "800000001",
"ReceivingConnection": "JHA",
"isActive": true,
"isJHA": true,
"Services": [
{
"Type": "ACK",
"Description": "Permits receipt of Payment Acknowledgement camt.035",
"isEnabled": true
},
{
"Type": "CRDT",
"Description": "Permits receipt of Credit Transfer pacs.008",
"isEnabled": true
},
{
"Type": "RFI",
"Description": "Permits receipt of Request for Information camt.026",
"isEnabled": true
},
{
"Type": "RFIR",
"Description": "Permits receipt of Request for Information Response camt.028",
"isEnabled": true
},
{
"Type": "RFP",
"Description": "Permits receipt of Request for Payment pain.013",
"isEnabled": true
},
{
"Type": "RFPR",
"Description": "Permits receipt of Request for Payment Response pain.014",
"isEnabled": false
},
{
"Type": "RFRF",
"Description": "Permits receipt of Request for Return of Funds camt.056",
"isEnabled": true
},
{
"Type": "RFRFR",
"Description": "Permits receipt of Request for Return of Funds Response camt.029",
"isEnabled": false
},
{
"Type": "RMT",
"Description": "Permits receipt of Remittance Advice remt.001",
"isEnabled": true
}
]
}
]
}
],
"Paging": {
"Results": 1,
"Total": 1,
"NextOffset": 0
},
"links": {
"prev": "",
"next": ""
}
}

Response 2: Sample

{
"FinancialInstitutions": [
{
"Id": 3,
"ParticipantId": "800000001T1",
"FinancialInstitutionName": "JHA Episys Certification CU ",
"RoutingNumbers": [
{
"RoutingNumber": "800000001",
"ReceivingConnection": "JHA",
"isActive": true,
"isJHA": true,
"Services": [
{
"Type": "ACK",
"Description": "Permits receipt of Payment Acknowledgement camt.035",
"isEnabled": true
},
{
"Type": "CRDT",
"Description": "Permits receipt of Credit Transfer pacs.008",
"isEnabled": true
},
{
"Type": "RFI",
"Description": "Permits receipt of Request for Information camt.026",
"isEnabled": true
},
{
"Type": "RFIR",
"Description": "Permits receipt of Request for Information Response camt.028",
"isEnabled": true
},
{
"Type": "RFP",
"Description": "Permits receipt of Request for Payment pain.013",
"isEnabled": true
},
{
"Type": "RFPR",
"Description": "Permits receipt of Request for Payment Response pain.014",
"isEnabled": false
},
{
"Type": "RFRF",
"Description": "Permits receipt of Request for Return of Funds camt.056",
"isEnabled": true
},
{
"Type": "RFRFR",
"Description": "Permits receipt of Request for Return of Funds Response camt.029",
"isEnabled": false
},
{
"Type": "RMT",
"Description": "Permits receipt of Remittance Advice remt.001",
"isEnabled": true
}
]
}
]
}
],
"Paging": {
"Results": 1,
"Total": 1,
"NextOffset": 0
},
"links": {
"prev": "",
"next": ""
}
}

Failure Response

{
"message": string,
"Error": {
"Code": string,
"Description": string
}
}

Error Response Sample

{
"message": "Validation Failed",
"Error": {
"Code": "ER1000001019",
"Description": "Invalid Parameter"
}
}