Update Cardholder – Function 036
Function 036 allows you to update your cardholder record. This call is generally used when your cardholder details are changed due to cardholder relocating to a new address or when wrong information was entered for the cardholder to begin with.
| Inputs | Description | Required | Data Type |
|---|---|---|---|
| FunctionID | 036 | Y | |
| P1 | First Name | Y | (1,20) varchar |
| P2 | Middle Initial * | Y | (1,1) varchar |
| P3 | Last Name | Y | (1,20) varchar |
| P4 | Address1 | Y | (1,30) varchar |
| P5 | Address2 * | Y | (1,30) varchar |
| P6 | City | Y | (1,25) varchar |
| P7 | State | Y | (1,30) varchar |
| P8 | Zip Code | Y | (5,15) varchar |
| P9 | Country Code (ISO 3166) | Y | (2) varchar |
| P10 | Client Card Holder ID | N | (1,32) varchar |
| P11 | DOB | Y | date (MMDDYYYY) |
| P12 | Phone | Y | (7,15) varchar |
| phone2 | Phone 2 *Phone2 (Mobile Phone) is required for programs which are enrolled for MasterCard 3DS through DPG. | N* | (7 -32) varchar |
| P13 | PAN OR ALT ID | Y | (16,19) Numeric |
| P14 | Security Field 1 can include mother’s maiden name or license number * | N | (1,22) varchar |
| P15 | Security Field 2 can include mother’s maiden name or license number * | N | (1,22) varchar |
| P16 | N | (1,40) varchar | |
| P17 | User defined field1. It handles special requirements for the client * | N | (1,16) varchar |
| P18 | User defined field2. It handles special requirements for the client * | N | (1,16) varchar |
| P19 | Social Security Number | N | (1,9) varchar |
| P20 | Distributor Code * | N | (1,8) varchar |
| P21 | Load Amount | N | Numeric |
| P22 | Company Name * | N | (1,38) varchar |
| P23 | Card Style | N | (1,2) varchar |
| P24 | Expiration Date | N | (1,4) varchar YYMM |
| P25 | Delivery Type | N | (1,2) varchar |
| P26 | OFAC Override | N | “Y” to override |
| P27 | VerifySSN Override | N | “Y” to override |
| P28 | VerifyDOB Override | N | “Y” to override |
| Remote_Host | IP address of the remote host | N | IP address. Used for velocity checks. |
| P29 | Other ID Type Used when passing personal IDs other than SSN. Will override P19 value. Identify ID type using: SSN (Social Sec Number) ITIN (Individual Tax ID) ATIN (Adoption Tax ID) NATIONAL_ID PASSPORT DRIVERS_LIC |
N | varchar(80) If a valid value is not provided associated data will be skipped. |
| P30 | ID Number | N | (1,80) varchar |
| P31 | ID Issuer | N | (1,80) varchar Identify the country or state that issued the ID |
| P32 | DDA Account Number – This value is a bank account number. This field may be used to override the system generated account number. Also utilized for ACH ** |
N | (1,19) varchar |
| P33 | DDA Routing Number ** | N | (1,12) varchar |
| P34 | DDA Validate ** | N | |
| P35 | Bank Account Type | N | Allowable Values: |
| 3DS Inputs |
Description | ||
| Language | Acceptable inputs: en_US de_DE es_ES fr_FR it_IT nb_NO sv_SE ENGLISH GERMAN SPANISH FRENCH ITALIAN NORWEGIAN SWEDISH |
N | varchar |
| SQ SA |
3DS Security question: SQ – Security Question SA – Security Answer *Please see 3DS note on formatting below |
N | varchar |
| Outputs | Description | ||
| P1 | Error Code | Y | |
| P2 | Error Text | Y |
Note: OFAC check function (‘056’) may be optionally executed for this function. If you are configured for Automated OFAC Checking, then any create card request will automatically check OFAC. If an OFAC Match is found, the Create Card Holder request will not be processed.
* Middle Initial, Address2, Security Field 1, Security Field 2, User Defined Field 1, User Defined Field 2, Distributor Code, or Company Name you can blank out the field using either two double quotes without a space between them, “”, or the word BLANK.
If you try to blank out First Name, Last Name, Address 1, City, State, Zip Code, Country Code, Phone, Email or SSN you will now get the following error.
P1=008&P2=A required field can only be updated it can’t be blanked out
Note that for now you can try to blank Personal ID. It will not return an error if you try, but if you do try the update will be simply ignored.
If you attempt to blank out other fields using the work BLANK or “” the value will replace whatever is there.
** ACH processing: When both values are present and the cardnumber starts with 2, micro-validation initiates.
What was the color of your first car?becomes
V2hhdCB3YXMgdGhlIGNvbG9yIG9mIHlvdXIgZmlyc3QgY2FyPwBluebecomes
MjRhODY2ZjQ5NDBmMWIwMDA4M2E3MWJhNGRmNzMyM2JhYzE0ODZmMjhkYzgxZDUwMGJiYzRiYjAyYzZlMGUxNg