Developer Resources
Details
SoapAction | http://jackhenry.com/ws/EFTCardMod |
Input Name | EFTCardMod |
Output Name | EFTCardModResponse |
Input Namespace | http://jackhenry.com/jxchange/TPG/2008 |
Group Name | Customer |
Container | TPG_CustomerMaster.xsd |
Operation Summary
OperationSummary-EFTCardMod
The EFTCardMod operation provides the ability to activate an EFT card, deactivate an EFT card, and modify the status of an EFT card. At a minimum, the request must include the EFTCardNum element representing the card number of the EFT card to modify. The status of the card can be modified by passing in the desired status code in the EFTCardModRec.EFTCardStat element.
The complete PassPort Card Status list is as follows:
Card Status | Description | Card Status | Description |
---|---|---|---|
A | Active | O | Order New Card |
C | Closed | P | PIN Mailer |
D | Deleted Card | R | Re-order Card |
E | Expired | S | Securomatic Deposits Only |
H | Hot Card | W | Warm Card - Deposits Only |
I | In Process Card Order | X | PIN Tries Exceeded |
L | Limits | Z | Do Not Reorder |
M | Manually Activate |
- To activate a card, EFTCardStat should be set to a value of A (Active). When changing EFTCardStat from W (Warm Card) or H (Hot Card) the CardStatRsnType value should be cleared by setting to an empty value.
- To report a debit card lost or stolen, EFTCardStat should be set to a value of H (Hot Card).
- When changing EFTCardStat to W (Warm Card) or H (HotCard), a CardStatRsnType must also be included. This canonical is defined as one of the following ISO-8583 values:
- 05 - Do Not Honor
- 33 - Expired Card, pick up
- 34 - Suspected Fraud, pick up
- 41 - Lost Card, pick up
- 43 - Stolen Card, pick up
- 59 - Suspected Fraud
The EFTCardMod response will return an RsStat element with a value of Success if the status was modified successfully.
If the EFT card number is unknown, it can be obtained by first calling the EFTCardSrch operation and passing in the customer id and/or debit account id:
EFTCardSrch Element | Description |
---|---|
CustId | The identifier attached to a customer |
Account Id | A complex element containing the incoming account identification information. The simple elements within this complex are: AcctId (Account Id) AcctType (Account Type) |
The EFTCardSrch response will contain an EFTCardSrchArray of results that match the customer id and/or debit account id in the request. Each record in the array will have an EFTCardNum element with the EFT card number. If no match is found, an array will not be returned and the response will contain a warning with an ErrCode value of 49 and ErrDesc of No Records Match Selection Criteria .
Travel Information
To update the Travel information (Start Date, End Date and Remarks), for a specific card, you will need to use the EFTCardMod message. It has three elements that support this information.
- EFTCardModRec.EFTCardTrvInfo.TrvStartDt
- EFTCardModRec.EFTCardTrvInfo.TrvEndDt
- EFTCardModRec.EFTCardTrvInfo.TrvRmk
You can find out more about this message that includes the Message Brief, Errors and the Mapping information to the core based Passport data here. You’ll need to login to the website if you aren’t already when you click the link.
One very important piece of information about the Travel elements: The FI must use JH’s Fraud Center, and subsequently PowerLink for this information to be at the Switch level. If the FI uses a 3rd party switch, the travel information is only informational, and not monitored for fraud.
Core Director Specfic Information
Here’s a breakdown of the international and travel fields that Core Director currently supports through jXchange:
- Field 259. International Flag. Field can be set via EFTCardModRec.AllowFornTrnType, where “Y” indicates to allow international transactions and “N” indicates to not allow
- Field 302. Vacation Start Date. Field 302. Vacation Start Date. Field can be set via EFTCardModRec.EFTCardTrvInfo.VacStartDt
- Field 303. Vacation End Date. Field can be set via EFTCardModRec.EFTCardTrvInfo.VacEndDt
- Field 301. Vacation Details. Field can be set via EFTCardModRec.EFTCardTrvInfo.VacRmk
- Field 298. Travel Start Date. Field can be set via EFTCardModRec.EFTCardTrvInfo.TrvStartDt
- Field 299. Travel End Date. Field can be set via EFTCardModRec.EFTCardTrvInfo.TrvEndDt
- Field 297. Travel Details. Field can be set via EFTCardModRec.EFTCardTrvInfo.TrvRmk