Transfer Search
Transfer Search
Transfer Search is a jXchange messaging service designed to allow a consumer to search transfer activity.
Message Flow
In jXchange, the Transfer Search service uses a typical exchange of MType
messages to allow a consumer
to search transfer activity.
Primary Request
The consumer forwards the XferSrchRq_MType
message to the
service provider.
The message contains the following simple elements:
- CustId
- HighAmt
- LowAmt
- ToOrFrom
- XferType
The message contains the following complex elements:
AccountId_CType
Custom_CType
SrchMsgRqHdr_CType
Primary Response
The service provider returns the XferSrchRs_MType
message to
the consumer.
The message contains the following simple elements:
- ToOrFrom
- XferType
The message contains the following complex elements:
Custom_CType
SrchMsgRsHdr_CType
The message contains the following arrays:
ACHXferSrchRecArray_AType
FutXferSrchRecArray_AType
XferSrchRecArray_AType
Transfer Search Behavior
The canonical values SemiMonthly, WeekSkipLast, WeekSkipFirst, BiWeekSkipLast, and BiWeekSkipFirst are explicit as to the frequency being requested. Therefore, the FutXferFreq element can be ignored by the Service Provider.
The default value for the location source of any transfer requests will be the Service Provider's current behavior. For example, if the jX message was considered a telephone transfer then the default should be Tele.
The ACH International Information Record complex includes all of the ACH related elements for international payments.
The NACHA rules indicate that the world does not distinguish between payments transmitted to either consumer or business accounts. Therefore, all international entries will use the standard entry code of International ACH Transactions (IAT). The contract provides the means to determine if the credit and/or debit side of the ACH transfer is for an international destination under the rules of NACHA for international payments.
The annotation was added to the Transaction Code and Transaction Code Description to convey to the consumer this element represents the credit side of the same day transfer request.
A Service Provider should try to return any restrictions that existed to the transfer to and/or from account identification at the time of the acceptance of the transaction.
The FutXferDayOfWeek and FutXferDayOfWeekOccur elements are closed enumerated elements.
In order to maintain backwards compatibility, the FutXferDayOfMonth element always takes precedence if sent in the request in addition to the FutXferDayOfWeek and FutXferDayOfWeekOccur elements.
Transfer Search Business Case
This is an example document.
In this situation, a mortgage lender needs to verify a money transfer from a consumer's bank into an escrow account created for automatic withdrawal of a monthly mortgage payment at a bank with a Service Provider. The transfer must be verified before the close of day if the consumer is to avoid a late payment fee on his mortgage.
Transfer Search - Message Flow Business Case
The lender sends a XferSrchRq_MType
to the Service
Provider. It includes the following values:
Complex Element | Simple Element | Entry Value |
---|---|---|
AccountId | AcctId | 1718891 |
AcctType | D | |
ToOrFrom | To | |
LowAmt | 1023.57 | |
HighAmt | 1023.57 |
The Service Provider checks only for transfers to
the account for the amount of $1023.57, and issues the response message of
XferSrchRs_MType
to the
lender with the following values:
Complex Element | Simple Element | Entry Value |
---|---|---|
ToOrFrom | To | |
XferSrchRec_CType | XferKey | Esc23224 |
AcctIdFrom_CType | AcctIdFrom | 332456 |
AcctIdTo_CType | AcctIdTo | 1718891 |
XferRec_CType | Amt | 1023.57 |
PrtRcpt | No | |
Fee | 000.00 | |
RedPrinc | N/A | |
OffCode | A1773 |
XferSrchRq_MType
XferSrchRq_MType
is a message
MType
element. This is a
message complex requesting real time information on transfers to and/or from
a specified account.
Contains:
AccountId_CType
Custom_CType
SrchMsgRqHdr_CType
Simple Elements
The following simple elements are contained within this message.
- CustId
- The identifier attached to a customer. It includes the OvrrdInstRtId attribute.
- HighAmt
- The value that designates an ending point for amount selections. Optional filter designating the amount to be used as the highest search criteria.
- LowAmt
- The value that designates a starting point for amount selections. Optional filter designating the amount to be used as the lowest search criteria.
- ToOrFrom
- Filter for included records to be only To Account or From Account.
Missing elements defaults to all records To or From account number are returned.
Canonical values are:
- From
- To
- To - Canonical value designating that the search should be performed on transfers to the designated account identified in the AcctId element.
- From - Canonical value designating that the search should be performed on transfers from the designated account identified in the AcctId.
- Blank - Designates that the search should include resulting transfers to and from the account identified in the AcctId.
- XferType
- Identifies the type of transfer operation. Canonical values are:
- ACH
- Fut
- Xfer
Designates whether the transfer is between accounts within a given financial institution, or between separate institutions.
AccountId_CType
AccountId_CType
is a complex
CType
element. This element contains the incoming account
identification information and any restrictions.
Simple Elements
The following simple elements are contained within this complex.
- AcctId
- The number or character that identifies an account record.
- AcctType
- The number or character that categorizes the AcctId.
- Rstr
- The level of restrictions that can exist at a parent and/or child
node. Canonical values are:
- Hid
- NoAccess
- NoAccessPart
- ReadOnly
- ReadOnlyPart
- ReadWrite
- ReadWritePart
Custom_CType
Custom_CType
is a complex CType
element.
This element is optional.
SrchMsgRqHdr_CType
SrchMsgRqHdr_CType
is a complex
CType
element. This is a
standard request message header.
Contains:
AuthenUsrCred_CType
jXchangeHdr_CType
Simple Elements
The following simple elements are contained within this complex.
- AuthenProdCred
- Authentication of the Consumer Product Credentials in the form of a WS Security element that contains a single SAML V2.0 Assertion.
- Cursor
- The state information that allows the next call to understand where it left off when returning multiple records and allowing a subsequent call to retrieve more records.
- MaxRec
- The maximum number of records when multiple records are returned.
AuthenUsrCred_CType
AuthenUsrCred_CType
is a complex CType
element. This element represents authentication of the end-user credentials in
the form of a WS Security element that contains a single SAML V2.0
Assertion.
Simple Elements
The following simple elements are contained within this complex.
- Security
- Defines the wsse:Security SOAP header element per section 4.
jXchangeHdr_CType
jXchangeHdr_CType
is a complex
CType
element.
Simple Elements
The following simple elements are contained within this complex.
- AuditUsrId
- The user ID that the consumer would like written in the audit as performing the requested service. It varies, but it could be the same as the user ID. It is not used to authenticate. It is used to audit the Soap Header Fault.
- AuditWsId
- The workstation ID that the consumer would like written in the audit as performing the requested service for the Soap Header Fault. It varies, but it could be the same as the user ID.
- AuthenUsrId
The user ID which the consumer would like the service provider to authenticate with for the Soap Header Fault. It is a user ID that the provider understands.
This element deprecates in accordance with XSD contract tenets. Effective date: 2017–01–01. The new complex element for user authentication credentials was added to both the Search Message Request Header
SrchMsgRqHdr_CType
and the Message Request HeaderMsgRqHdr_CType
. AuthenUsrId is ignored by the service providers when the authentication user credentialsAuthenUsrCred_CType
package is delivered. The expectation is that the password credentials and the user name token are provided in the authentication user credential complex element in accordance with the standards established by WS-Security.- BusCorrelId
- The correlation identification as related to business functions and activities.
- ConsumerName
- The name of the service consumer (business name) for the Soap Header Fault.
- ConsumerProd
- The name of the product which is consuming the service (business product name) for the Soap Header Fault.
- 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.
- jXLogTrackingId
- An identification provided by jXchange to be able to trace the request and response of a message from the third-party gateway, internal gateway, and service provider for the Soap Header Fault.
- JxVer
- Contains the version jXchange is running for the Soap Header Fault.
- ValidConsmName
- The consumer name that can be validated by enterprise governance. The canonical values are managed in a consumer/product enterprise table. The canonical value is: JHA.
- ValidConsmProd
- The consumer product name that can be validated by enterprise governance. The canonical values are managed in a consumer/product enterprise table.
- WorkflowCorrelId
- The correlation identification as related to workflow functions and activities.
jXchangeHdr_CType Deprecation Details
- AuthenUsrId
The user ID which the consumer would like the service provider to authenticate with for the Soap Header Fault. It is a user ID that the provider understands.
This element deprecates in accordance with XSD contract tenets. Effective date: 2017–01–01. The new complex element for user authentication credentials was added to both the Search Message Request Header
SrchMsgRqHdr_CType
and the Message Request HeaderMsgRqHdr_CType
. AuthenUsrId is ignored by the service providers when the authentication user credentialsAuthenUsrCred_CType
package is delivered. The expectation is that the password credentials and the user name token are provided in the authentication user credential complex element in accordance with the standards established by WS-Security.
XferSrchRs_MType
XferSrchRs_MType
is a
message MType
element. This message complex returns the
details of the transaction, as well as an identity key to identify
it.
Contains:
ACHXferSrchRecArray_AType
Custom_CType
FutXferSrchRecArray_AType
SrchMsgRsHdr_CType
XferSrchRecArray_AType
Simple Elements
The following simple elements are contained within this message.
- ToOrFrom
- Filter for included records to be only To Account or From Account.
Missing elements defaults to all records To or From account number are returned.
Canonical values are:
- From
- To
- To - Canonical value designating that the search should be performed on transfers to the designated account identified in the AcctId element.
- From - Canonical value designating that the search should be performed on transfers from the designated account identified in the AcctId.
- Blank - Designates that the search should include resulting transfers to and from the account identified in the AcctId.
- XferType
- Identifies the type of transfer operation. Canonical values are:
- ACH
- Fut
- Xfer
Designates whether the transfer is between accounts within a given financial institution, or between separate institutions.
ACHXferSrchRecArray_AType
ACHXferSrchRecArray_AType
is an
array AType
element. This is an array of responses for an
ACH transfer search.
Contains:
ACHXferSrchRec_CType
ACHXferSrchRec_CType
ACHXferSrchRec_CType
is a complex
CType
element. This complex
defines a transfer through an automated clearing house (bank to bank
transfer).
Contains:
AcctIdFrom_CType
AcctIdTo_CType
ACHXferRec_CType
Simple Elements
The following simple elements are contained within this complex.
- ACHAcctStatDesc
- The ACH account status description.
- ACHCrBrDesc
- The description of the branch code for the ACH credit account.
- ACHCrTrnCodeDesc
- The description of the transaction code for the ACH credit account.
- ACHDrBrDesc
- The description of the branch code for the ACH debit account.
- ACHDrTrnCodeDesc
- The description of the transaction code for the ACH debit account.
- ACHFeeCrBrDesc
- The description of the branch code of the fee credit account for the ACH transfer request.
- ACHFeeDrTrnCodeDesc
- The description of the transaction code of the fee debit account for the ACH transfer request.
- ACHNSFDesc
- The description of the code that references how the ACH transfer behaves if the debit AcctId does not have sufficient funds to cover the transfer request.
- ACHSendPreNoteDesc
- The description of the code that determines if an ACH prenotification should be generated, as governed by Nacha® rules.
- ACHUseLnAmtDesc
- The description of the code that references how the ACH transfer amount behaves if the credit AcctId is a loan.
- ACHUseLnDtDesc
- The description of the code that references how the ACH transfer date behaves if the credit AcctId is a loan.
- ACHXferMatPmtDesc
- The description of the code that describes the behavior for loan payments at maturity for ACH transfers.
- CustIdFrom
- The identifier attached to a customer.
- CustIdTo
- The identifier attached to a customer.
- LnUnitId
- The identification assigned to a unit of a loan.
- XferKey
- The transfer key returned in search/inquiry requests and is needed to modify or delete a transfer.
AcctIdFrom_CType
AcctIdFrom_CType
is a complex CType
element. This element is the
source description (AcctId
and
AcctType
) for a
source/destination transfer.
Simple Elements
The following simple elements are contained within this complex.
- FromAcctId
- The source account ID.
- FromAcctType
- The source account type.
AcctIdTo_CType
AcctIdTo_CType
is a complex CType
element. This is the destination description (AcctId
and AcctType
) for a
source/destination transfer.
Simple Elements
The following simple elements are contained within this complex.
- ToAcctId
- The destination account ID.
- ToAcctType
- The destination account type.
ACHXferRec_CType
ACHXferRec_CType
is a complex CType
element. This complex defines a transfer through an ACH transaction (bank to
bank transfer). This is not included if the XferType
is Xfer
.
Contains:
ACHAddendaArray_AType
ACHIntlInfoRec_CType
EftDescArray_AType
Simple Elements
The following simple elements are contained within this complex.
- AcctStat
- The account status.
- ACHAltCompName
- The alternate company name that can be used for EFT description requirements.
- ACHCompDiscrData
- The ACH company discretionary data, as governed by Nacha® rules.
- ACHCompEntryDesc
- The ACH company entry description, as governed by Nacha® rules.
- ACHCompId
- The ACH company ID.
- ACHCompName
- The ACH company name, as governed by Nacha® rules.
- ACHCrAcctId
- The account ID of the credit account for the ACH item.
- ACHCrAcctType
- The account type of the ACH credit account ID.
- ACHCrName
- The account holder's name of the credit account for the ACH item.
- ACHCrTrnCodeCode
- The transaction code for the ACH credit account.
- ACHDayAdv
- The number of days in advance to create the ACH transfer request.
- ACHDrAcctId
- The account ID of the debit account for the ACH item.
- ACHDrAcctType
- The account type of the ACH debit account ID.
- ACHDrBrCode
- The branch code for the ACH debit account.
- ACHDrName
- The account holder's name of the debit account for the ACH item.
- ACHDrRtNum
- The routing and transit number of the debit account's bank for the ACH item.
- ACHDrTrnCodeCode
- The transaction code for the ACH debit account.
- ACHFeeAmtLTD
- The life-to-date fee amount that has been collected for each ACH transaction created.
- ACHFeeAmt
- The fee amount to be collected for each ACH transaction created.
- ACHFeeCrAcctId
- The account ID of the fee credit account for the ACH transfer request.
- ACHFeeCrAcctType
- The account type of the fee credit account for the ACH transfer request.
- ACHFeeCrBrCode
- The branch code of the fee credit account for the ACH transfer request.
- ACHFeeCrRtNum
- The routing and transit number of the fee credit account's bank for the ACH transfer request.
- ACHFeeCrTrnCodeCode
- The transaction code of the fee credit account for the ACH transfer request.
- ACHFeeDrAcctId
- The account ID of the fee debit account for the ACH transfer request.
- ACHFeeDrAcctType
- The account type of the fee debit account for the ACH transfer request.
- ACHFeeDrBrCode
- The branch code of the fee debit account for the ACH transfer request.
- ACHFeeDrRtNum
- The routing and transit number of the fee debit account's bank for the ACH transfer request.
- ACHFeeDrTrnCodeCode
- The transaction code of the fee debit account for the ACH transfer request.
- ACHIndvId
- The ID entered by the originator provides additional identification for the ACH receiver and may be helpful in identifying the consumer.
- ACHLastMainDt
- The last maintenance date.
- ACHLastXferDt
- The date of the last ACH transfer request.
- ACHNextXferDay
- The specific day of the month of each ACH transfer request.
- ACHNextXferDt
- The date of the next ACH transfer request.
- ACHNSFCode
- The code that references how the ACH transfer should behave if the debit AcctId does not have sufficient funds to cover the transfer request.
- ACHOneTime
- Indicates if the ACH transfer should only occur one time and then expire.
- ACHOpenDt
- The date opened.
- ACHSemiDay1
- The day of month for first semi-monthly payment.
- ACHSemiDay2
- The day of month for second semi-monthly payment.
- ACHSendPreNoteCode
- The code that determines if an ACH prenotification should be generated, as governed by Nacha® rules.
- ACHStdEntryClass
- The ACH standard entry class.
- ACHTermCnt
- The integer length of the term.
- ACHTermUnits
- The term units: years, months, days, indefinite. Canonical values
are:
- Days
- Indefinite
- Months
- NA
- SemiMonthly
- Years
- ACHUseLnAmtCode
- The code that references how the ACH transfer amount should behave if the credit AcctId is a loan.
- ACHUseLnDtCode
- The code that references how the ACH transfer date should behave if the credit AcctId is a loan.
- ACHXferAmtLTD
- The life-to-date transfer amount for the ACH transactions.
- ACHXferAmt
- The transfer amount for the ACH transaction.
- ACHXferExpireDt
- The expiration date of the ACH transfer request.
- ACHXferMatPmtCode
- The code that describes the behavior for loan payments at maturity for ACH transfers.
- LnUnitId
- The identification assigned to a unit of a loan.
- RedPrinc
- Canonical values are:
- false
- true
- XferBalType
- Answers the question: What balances should be considered for
transfer requests? Canonical values are:
- Avl
- Col
- Ldgr
- XferSrcType
- The source of the transfer request. Canonical values are:
- ATM
- InPerson
- Intnet
- Mob
- Tele
ACHAddendaArray_AType
ACHAddendaArray_AType
is an array AType
element. This is an array containing ACH
addenda records.
Contains:
ACHAddendaInfoRec_CType
ACHAddendaInfoRec_CType
ACHAddendaInfoRec_CType
is a
complex CType
element.
Simple Elements
The following simple elements are contained within this complex.
- ACHAddenda
- An ACH record type carrying the supplemental data needed to completely identify an account holder or provide information concerning a payment to the RDFI and the receiver.
ACHIntlInfoRec_CType
ACHIntlInfoRec_CType
is a complex
CType
element.
Contains:
ACHIntlAddendaArray_AType
Simple Elements
The following simple elements are contained within this complex.
- ACHIntlType
- Defines which side of the ACH transfer belongs to an international
entity. Canonical values are:
- Credit
- Debit
- ACHRecvId
- An originator trace number provided to the receiver of the ACH transactions.
- ACHStdEntryClass
- The ACH standard entry class.
- FornExchRef
- The foreign exchange rate used to run the foreign exchange conversion for international items in accord with Nacha® standards.
- FornExchRefType
- The code used to indicate the content of the foreign exchange
reference for international items in accord with Nacha® standards. Canonical values are:
- FornExchRate
- FornExchRef
- NA
- FornExchType
- The code used to indicate the foreign exchange conversion
methodology applied to international items in accord with Nacha® standards. Canonical values are:
- Fix
- FixVar
- VarFix
- FornPmtAmt
- The amount of foreign payment as expressed in the destination currency code.
- ISODestCntry
- The code as approved by the International Organization for Standardization (ISO) used to identify the destination country for international items in accordance with Nacha® standards.
- ISODestCur
- The code as approved by the ISO used to identify the currency denomination of the destination country for international items in accordance with Nacha® standards.
- ISOOrigCur
- The code as approved by the ISO used to identify the currency denomination of the origination country for international items in accordance with Nacha® standards.
ACHIntlAddendaArray_AType
ACHIntlAddendaArray_AType
is an
array AType
element. This is an array of ACH international
addenda records.
Contains:
ACHIntlAddendaInfoRec_CType
ACHIntlAddendaInfoRec_CType
ACHIntlAddendaInfoRec_CType
is a
complex CType
element.
Simple Elements
The following simple elements are contained within this complex.
- ACHCompName
- The ACH company name, as governed by Nacha® rules.
- ACHIntlAddendaType
- The type that defines the classification of the ACH international
addenda. Canonical values are:
- Orign
- Recv
- City
- The city name.
- Cntry
- The country name.
- CntryType
- The country abbreviation from ISO 3166.
- FinInstName
- The depository financial institution name.
- FinInstQualId
- Identifies the numbering scheme used in the depository financial
institution identification element. Canonical values are:
- BIC
- NCSN
- IBAN
- 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.
- PostalCode
- The postal code or ZIP code.
- StateProv
- The state or province or region.
- StreetAddr1
- The street address.
EFTDescArray_AType
EFTDescArray_AType
is an array
AType
element.
Contains:
EftDescInfo_CType
EftDescInfo_CType
EftDescInfo_CType
is a complex
CType
element.
Simple Elements
The following simple elements are contained within this complex.
- EftDesc
- A free-format description that further defines pertinent information about the transactions. Often associated with electronic transaction types.
Custom_CType
Custom_CType
is a complex CType
element.
This element is optional.
FutXferSrchRecArray_AType
FutXferSrchRecArray_AType
is an
array AType
element. This is an array of responses for a
future dated transfer search.
Contains:
FutXferSrchRec_CType
FutXferSrchRec_CType
FutXferSrchRec_Type
is a complex
CType
element.
Contains:
AcctIdFrom_CType
AcctIdTo_CType
Custom_CType
FutXferRec_CType
Simple Elements
The following simple elements are contained within this complex.
- CustIdFrom
- The identifier attached to a customer.
- CustIdTo
- The identifier attached to a customer.
- FutXferLateChgDesc
- The description of the code that references how the transfer amount
behaves if the
ToAcctId
is a loan and the loan has late charges due. - FutXferMatPmtDesc
- The description of the code that describes the behavior for loan payments at maturity for future transfers.
- FutXferNSFDesc
- The description of the code that references how the transfer behaves
if the
FromAcctId
does not have sufficient funds to cover the transfer request. - FutXferUseLnAmtDesc
- The description of the code that references how the transfer amount
behaves if the
ToAcctId
is a loan. - FutXferUseLnDtDesc
- The description of the code that references how the transfer date
behaves if the
ToAcctId
is a loan. - LnUnitId
- The identification assigned to a unit of a loan.
- TrnCodeDesc
- The description of the code that identifies the behavior of a monetary transaction.
- XferKey
- The transfer key returned in search/inquiry requests and is needed to modify or delete a transfer.
AcctIdFrom_CType
AcctIdFrom_CType
is a complex CType
element. This element is the
source description (AcctId
and
AcctType
) for a
source/destination transfer.
Simple Elements
The following simple elements are contained within this complex.
- FromAcctId
- The source account ID.
- FromAcctType
- The source account type.
AcctIdTo_CType
AcctIdTo_CType
is a complex CType
element. This is the destination description (AcctId
and AcctType
) for a
source/destination transfer.
Simple Elements
The following simple elements are contained within this complex.
- ToAcctId
- The destination account ID.
- ToAcctType
- The destination account type.
Custom_CType
Custom_CType
is a complex CType
element.
This element is optional.
FutXferRec_CType
FutXferRec_CType
is a complex CType
element.
Contains:
EFTDescArray_AType
GLTrnDescArray
referencesRmk_AType
Simple Elements
The following simple elements are contained within this complex.
- Amt
- The amount or quantity.
- FutXferAmtLTD
- The life-to-date transfer amount for the transfer transactions.
- FutXferDayOfMonth
- The day of the month for transfer transaction. This day is only required if the transfer date is the 29th of the month.
- FutXferDayOfWeekOccur
- The day of week occurrence. Canonical values are:
- First
- Secd
- Third
- Fourth
- Last
- FutXferDayOfWeek
- The day of the week. Canonical values are:
- Mon
- Tues
- Wed
- Thur
- Fri
- Sat
- Sun
- FutXferExpDt
- The expiration date of the transfer request.
- FutXferFirstDt
- The first date to start a future transfer request.
- FutXferFreq
- The frequency of the transfer.
- FutXferFreqUnits
- The units of frequency for the transfer request. Canonical values
are:
- BiWeekSkipFirst
- BiWeekSkipLast
- Days
- Indefinite
- Months
- NA
- SemiMonthly
- WeekSkipFirst
- WeekSkipLast
- Years
- FutXferLateChgCode
- The code that references how the transfer amount should behave if
the
ToAcctId
is a loan and the loan has late charges due. - FutXferMatPmtCode
- The code that describes the behavior for loan payments at maturity for future transfers.
- FutXferNextDt
- The next scheduled transfer date.
- FutXferNSFCode
- The code that references how the transfer should behave if the
FromAcctId
does not have sufficient funds to cover the transfer request. - FutXferOccr
- The number of occurrences for future dated transfer requests.
- FutXferSuspEndDt
- The end date to suspend the transfer request.
- FutXferSuspStartDt
- The begin date to suspend the transfer request.
- FutXferUseLnAmtCode
- The code that references how the transfer amount behaves if the
ToAcctId
is a loan. - FutXferUseLnDtCode
- The code that references how the transfer date behaves if the
ToAcctId
is a loan. - LnUnitId
- The identification assigned to a unit of a loan.
- PrtPartRcpt
- Answers the question: Should a receipt be printed for partial
transactions? Canonical values are:
- false
- true
- PrtRcpt
- Print receipt. Canonical values are:
- false
- FirstRcptOnly
- FromAcct
- ToAcct
- true
- RcptDlvryMthd
- The method used to deliver receipts to customers. Canonical values
are:
- RedPrinc
- Canonical values are:
- false
- true
- SemiDay1
- The day of month for first semi-monthly payment.
- SemiDay2
- The day of month for second semi-monthly payment.
- TrnCodeCode
- The code that identifies the behavior of a monetary transaction.
- XferSrcType
- The source of the transfer request. Canonical values are:
- ATM
- InPerson
- Intnet
- Mob
- Tele
EFTDescArray_AType
EFTDescArray_AType
is an array
AType
element.
Contains:
EftDescInfo_CType
EftDescInfo_CType
EftDescInfo_CType
is a complex
CType
element.
Simple Elements
The following simple elements are contained within this complex.
- EftDesc
- A free-format description that further defines pertinent information about the transactions. Often associated with electronic transaction types.
GLTrnDescArray_AType
Rmk_AType
is an array
AType
element. This is an array of application or user
remarks in free form text.
GLTrnDescArray
references Rmk_AType
.
Contains:
RmkInfo_CType
RmkInfo_CType
RmkInfo_CType
is a complex
CType
element.
Simple Elements
The following simple elements are contained within this complex.
- Rmk
- Application or user remarks free-form text.
SrchMsgRsHdr_CType
SrchMsgRsHdr_CType
is a complex
CType
element. It searches
specific message response headers.
Contains:
jXchangeHdr_CType
MsgRecInfoArray_AType
Simple Elements
The following simple elements are contained within this complex.
- Cursor
- The state information that allows the next call to understand where it left off when returning multiple records and allowing a subsequent call to retrieve more records.
- MoreRec
- Indicates if there are more records that could be returned.
Canonical values are:
- false
- true
- SentRec
- The number of records sent in the response.
- TotRec
- Indicates the total records the request selected, which could be
larger than
MaxRec.
jXchangeHdr_CType
jXchangeHdr_CType
is a complex
CType
element.
Simple Elements
The following simple elements are contained within this complex.
- AuditUsrId
- The user ID that the consumer would like written in the audit as performing the requested service. It varies, but it could be the same as the user ID. It is not used to authenticate. It is used to audit the Soap Header Fault.
- AuditWsId
- The workstation ID that the consumer would like written in the audit as performing the requested service for the Soap Header Fault. It varies, but it could be the same as the user ID.
- AuthenUsrId
The user ID which the consumer would like the service provider to authenticate with for the Soap Header Fault. It is a user ID that the provider understands.
This element deprecates in accordance with XSD contract tenets. Effective date: 2017–01–01. The new complex element for user authentication credentials was added to both the Search Message Request Header
SrchMsgRqHdr_CType
and the Message Request HeaderMsgRqHdr_CType
. AuthenUsrId is ignored by the service providers when the authentication user credentialsAuthenUsrCred_CType
package is delivered. The expectation is that the password credentials and the user name token are provided in the authentication user credential complex element in accordance with the standards established by WS-Security.- BusCorrelId
- The correlation identification as related to business functions and activities.
- ConsumerName
- The name of the service consumer (business name) for the Soap Header Fault.
- ConsumerProd
- The name of the product which is consuming the service (business product name) for the Soap Header Fault.
- 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.
- jXLogTrackingId
- An identification provided by jXchange to be able to trace the request and response of a message from the third-party gateway, internal gateway, and service provider for the Soap Header Fault.
- JxVer
- Contains the version jXchange is running for the Soap Header Fault.
- ValidConsmName
- The consumer name that can be validated by enterprise governance. The canonical values are managed in a consumer/product enterprise table. The canonical value is: JHA.
- ValidConsmProd
- The consumer product name that can be validated by enterprise governance. The canonical values are managed in a consumer/product enterprise table.
- WorkflowCorrelId
- The correlation identification as related to workflow functions and activities.
jXchangeHdr_CType Deprecation Details
- AuthenUsrId
The user ID which the consumer would like the service provider to authenticate with for the Soap Header Fault. It is a user ID that the provider understands.
This element deprecates in accordance with XSD contract tenets. Effective date: 2017–01–01. The new complex element for user authentication credentials was added to both the Search Message Request Header
SrchMsgRqHdr_CType
and the Message Request HeaderMsgRqHdr_CType
. AuthenUsrId is ignored by the service providers when the authentication user credentialsAuthenUsrCred_CType
package is delivered. The expectation is that the password credentials and the user name token are provided in the authentication user credential complex element in accordance with the standards established by WS-Security.
MsgRecInfoArray_AType
MsgRecInfoArray_AType
is an array
AType
element. This is an array of messages that can be
returned in a response.
Contains:
MsgRec_CType
MsgRec_CType
MsgRec_CType
is a complex
CType
element.
Simple Elements
The following simple elements are contained within this complex.
- ErrCat
- The Soap Header Fault error category.
- ErrCode
- The error code.
- ErrDesc
- The Soap Header Fault error description.
- ErrElem
- The Soap Header Fault when an error or fault occurs. This optional element contains the element which is causing the error condition.
- ErrElemVal
- The Soap Header Fault when an error or fault occurs. This optional element contains the value of the element which is causing the error condition.
- ErrLoc
- The Soap Header Fault error location. This is typically the program that generated the error condition.
XferSrchRecArray_AType
XferSrchRecArray_ATYpe
is an array AType
element. This is an array of responses for a transfer search.
Contains:
XferSrchRec_CType
XferSrchRec_CType
XferSrchRec_CType
is a complex
CType
element. This is an optional complex detailing the
transaction. There can be multiple XferSrchRec
complexes
forwarded to detail multiple transactions to the specified
account.
Contains:
AcctIdFrom_CType
AcctIdTo_CType
CustomXferSrchRec
referencesCustom_CType
XferRec_CType
Simple Elements
The following simple elements are contained within this complex.
TrnCodeDesc
is applied to the
credit side of the transfer transaction.
- CustIdFrom
- The identifier attached to a customer.
- CustIdTo
- The identifier attached to a customer.
- DrTrnCodeDesc
- The description of the code that identifies the behavior of a monetary transaction.
- LnUnitId
- The identification assigned to a unit of a loan.
- TrnCodeDesc
- The description of the code that identifies the behavior of a monetary transaction.
- XferKey
- The transfer key returned in search/inquiry requests and is needed to modify or delete a transfer.
AcctIdFrom_CType
AcctIdFrom_CType
is a complex CType
element. This element is the
source description (AcctId
and
AcctType
) for a
source/destination transfer.
Simple Elements
The following simple elements are contained within this complex.
- FromAcctId
- The source account ID.
- FromAcctType
- The source account type.
AcctIdTo_CType
AcctIdTo_CType
is a complex CType
element. This is the destination description (AcctId
and AcctType
) for a
source/destination transfer.
Simple Elements
The following simple elements are contained within this complex.
- ToAcctId
- The destination account ID.
- ToAcctType
- The destination account type.
Custom_CType
Custom_CType
is a complex CType
element.
This element is optional.
XferRec_CType
XferRec_CType
is a complex CType
element. This is the complex
that details the transfer. It is not included if the XferType
is ACH.
Contains:
ApprvOffInfoArray_CType
EftDescArray_AType
XferSrcDestRstrArray_AType
Simple Elements
The following simple elements are contained within this complex.
- Amt
- The amount or quantity.
- AvlBalCalcCode
- A code that conveys to the service provider the method to use for the calculation of the available balance.
- DrTrnCodeCode
- The code that identifies the behavior of a monetary transaction.
- EFTTrnId
- A document reference assigned to an EFT transaction by the originating entity.
- Fee
- The fee amount.
- LnUnitId
- The identification assigned to a unit of a loan.
- OffCode
- The code that designates the financial institution officer.
- PrtRcpt
- Print receipt. Canonical values are:
- false
- FirstRcptOnly
- FromAcct
- ToAcct
- true
- RedPrinc
- Canonical values are:
- false
- true
- TrnAcptTimeDt
- The date and time a transaction was accepted.
- TrnCodeCode
- The code that identifies the behavior of a monetary transaction.
- XferSrcType
- The source of the transfer request. Canonical values are:
- ATM
- InPerson
- Intnet
- Mob
- Tele
ApprvOffInfoArray_AType
ApprvOffInfoArray_AType
is an
array AType
element. This is an array of approval officers.
Contains:
ApprvOffInfoRec_CType
ApprvOffInfoRec_CType
ApprvOffInfoRec_CType
is a
complex CType
element.
Simple Elements
The following simple elements are contained within this complex.
- ApprvOffCode
- The approving officer code.
- ApprvOffDesc
- The approving officer description.
- ApprvType
- The optional element contains the element name as defined in the enterprise dictionary and published as enterprise variables, which requires an officer approval. The service provider would convey the elements that could need approval by the Service Dictionary Search.
EFTDescArray_AType
EFTDescArray_AType
is an array
AType
element.
Contains:
EftDescInfo_CType
EftDescInfo_CType
EftDescInfo_CType
is a complex
CType
element.
Simple Elements
The following simple elements are contained within this complex.
- EftDesc
- A free-format description that further defines pertinent information about the transactions. Often associated with electronic transaction types.
XferSrcDestRstrArray_AType
XferSrcDestRstrArray_AType
is an array
AType
element. This is an array of elements that indicates
the restrictions that could exist on the transfer account.
Contains:
XferSrcDestRstrInfo_CType
XferSrcDestRstrInfo_CType
XferSrcDestRstrInfo_CType
is a complex CType
element.
Simple Elements
The following simple elements are contained within this complex.
- RstrExcType
- The type of restrictions to be excluded from a response set.
Canonical values are:
- ChgdOff
- Cls
- Dormant
- Escheat
- Frz
- LmtTrn
- NoCr
- NoPost
- RstrTrn
- XferSrcDestType
- Indicates the role of the transfer request as the source or
destination. Canonical values are:
- Both
- Dest
- Src