Skip to content
Breadcrumbs

TexPayment Resource

Note: To navigate this guide on a mobile device you must use the Table of Contents.

TINS Codes
Exception (Error) Messages

TINS exception codes and messages appear on non-processed/warning reports for transactions submitted by batch. Only the error codes display on the Payee Maintenance Transaction History (PMTHIS) screen.

TINS displays error messages during online entry and are self-explanatory. However, error messages that appear during online processing do not appear on PMTHIS as the user is required to correct the errors before online transactions can process successfully.

Click on a column heading to sort by that column
Error Code Message Comment
001 TIN MUST BE 11 DIGITS Only online inquiry allows for a 10–digit TIN, and TINS calculates the check digit
002 TIN ALREADY EXISTS ON FILE  
003 TIN NOT FOUND ON FILE Replaced with Error Code 700 (Master Setup Required) effective September 2013. Error code will still display on PMTHIS for batch transactions submitted before September 2013.
004 FIRST DIGIT OF TIN/HOLD NUMBER MUST BE 1, 2, 3 OR 7  
005 CHECK DIGIT IS INCORRECT FOR TIN/HOLD NUMBER  
006 INVALID AGENCY NUMBER  
007 INVALID INPUT SOURCE  
008 TAXPAYER NUMBER MUST BE 11 DIGITS  
009 FIRST DIGIT OF TAXPAYER NUMBER MUST BE 1 OR 3  
011 INVALID OWNERSHIP TYPE See Ownership Types
012 OWNERSHIP TYPE NOT VALID WITH EIN BASED NUMBER The following ownership types cannot be used on payee setups with an EIN–based number:
  • E – Employee
  • I – Individual
  • S – Sole Owner
See Ownership Types
013 OWNER NAME REQUIRED FOR OWNERSHIP TYPE S–SOLE OWNERSHIP  
014 OWNER NAME ONLY ALLOWED IF OWNERSHIP TYPE S–SOLE OWNERSHIP  
015 OWNER SSN/ITIN ONLY ALLOWED IF OWNERSHIP TYPE S–SOLE OWNERSHIP  
016 OWNER SSN/ITIN REQUIRED IF OWNERSHIP TYPE S–SOLE OWNERSHIP  
017 OWNER SSN/ITIN MUST BE 9 DIGITS Batch requires 11–digit SSN– or ITIN–based number
(2 + SSN / ITIN + check digit)
018 FIRST DIGIT OF OWNER SSN/ITIN MUST BE A 2 Batch requires 11–digit SSN– or ITIN–based number.
(2 + SSN / ITIN + check digit)
019 INVALID CHECK DIGIT FOR OWNER SSN/ITIN  
020 PARTNER SSN/EIN/ITIN ONLY ALLOWED FOR OWNERSHIP TYPE P–PARTNERSHIP  
021 PARTNER SSN/EIN/ITIN REQUIRED FOR OWNERSHIP TYPE P–PARTNERSHIP  
022 PARTNER SSN/EIN/ITIN MUST BE 9 DIGITS Batch requires 11–digit SSN–, EIN– or ITIN–based number for partner identification numbers:
  • 1 + EIN + check digit if partner is a business entity
  • 2 + SSN / ITIN + check digit if partner is an individual
023 FIRST DIGIT OF PARTNER SSN/EIN/ITIN MUST BE 1 OR 2
  • 1 + EIN + check digit if partner is a business entity
  • 2 + SSN / ITIN + check digit if partner is an individual
024 INVALID CHECK DIGIT FOR PARTNER SSN/EIN/ITIN Batch requires 11–digit SSN–, EIN– or ITIN–based number for partner identification numbers.
025 PARTNER NAME REQUIRED FOR OWNERSHIP TYPE P–PARTNERSHIP Ownership type ‘P’ requires the names and identification numbers of two partners, which may be either an individual and/or business entity.
026 PARTNER NAME ONLY ALLOWED FOR OWNERSHIP TYPE P–PARTNERSHIP  
027 CHARTER NUMBER ONLY ALLOWED FOR OWNERSHIP TYPE T, C, L OR A  
028 CHARTER NUMBER REQUIRED FOR OWNERSHIP TYPE T, C, L OR A  
030 STATUS MUST BE A–ACTIVE, I–INACTIVE  
031 THE CHARACTERS “.” , “,” , AND “%” ARE NOT ALLOWED IN THE NAME FIELD Error message applies to:
  • Name on mail code
  • Sole owner name
  • Partner names
  • Name on payee hold transactions
032 OWNERSHIP TYPE NOT VALID FOR SSN/ITIN BASED NUMBER Only the following ownership types allow for SSN– or ITIN–based numbers:
  • E – Employee
  • I – Individual
  • S – Sole Owner
See Ownership Types
033 INPUT SOURCE MUST BE ENTERED TINS online defaults the field to the user’s agency number
034 OWNERSHIP TYPE MUST BE ENTERED See Ownership Types
035 CHARTER NUMBER MUST BE 10 DIGITS If the charter number assigned by Secretary of State is less than 10 digits, add preceding zeros
036 THE NAME FIELD CANNOT CONTAIN LOWER CASE CHARACTERS Online allows for upper or lower case characters.
037 PARTNERS’ SSN/EIN/ITIN CANNOT BE THE SAME Two separate partner identification (ID) numbers are required. The ID numbers of Partner 1 and Partner 2 cannot be the same.
040 TIN/HOLD NUMBER CANNOT BEGIN WITH “100” OR “2000” TIN and Hold number are validated against the criteria set by Social Security Administration for SSNs and Internal Revenue Service for EINs and ITINs.
042 SIC CODE MUST BE 4 DIGITS See SIC Codes
043 SECURITY LEVEL MUST BE “0”, “1”, OR “2”  
044 SOLE OWNER TIN MUST BEGIN WITH “1” OR “2” OR “3” Batch requires:
  • 11-digit SSN- or ITIN-based number (2 + SSN / ITIN + check digit), or
  • 11-digit Comptroller-assigned number that begins with ‘3’
045 TP# ALREADY EXISTS UNDER A DIFFERENT ACTIVE TIN Restricted to Comptroller users
046 TIN ALREADY EXISTS AS A TP UNDER A DIFFERENT ACTIVE TIN Restricted to Comptroller users
047 REQUESTED TP# ALREADY EXISTS AS AN ACTIVE TINWITH A DIFFERENT TP# Restricted to Comptroller users
048 REQUESTED TP# ALREADY EXISTS UNDER A DIFFERENT ACTIVE TIN Restricted to Comptroller users
049 CHG NOT ALLOWED, NEW TIN EXISTS AS A TP UNDER ACTIVE TIN Restricted to Comptroller users
050 CHG NOT ALLOWED, OLD TP# EXISTS AS A TP UNDER ACTIVE TIN Restricted to Comptroller users
051 CHG NOT ALLOWED, OLD TIN EXISTS AS A TP UNDER ACTIVE TIN Restricted to Comptroller users
052 NEW TIN AND OLD TP# ARE TP UNDER DIFFERENT ACTIVE TINS Restricted to Comptroller users
053 NEW TIN AND OLD TIN ARE TP UNDER DIFFERENT ACTIVE TINS Restricted to Comptroller users
054 OLD TIN AND OLD TP# ARE TP UNDER DIFFERENT ACTIVE TINS Restricted to Comptroller users
055 CHG NOT ALLOWED, OLD TP# EXISTS AS A TP UNDER ACTIVE TIN = TO TP# Restricted to Comptroller users
057 OWNER’S SSN/ITIN MUST = PAYEE’S SSN/ITIN
  • If a payee master record (TIN) is set up with an SSN- or ITIN-based number, the sole owner’s SSN or ITIN field must match the SSN or ITIN used for the TIN.
  • If a payee master record (TIN) is set up with an EIN-based number, an SSN- or ITIN- based number is still required for the sole owner number.
058 RESEARCH REQUIRED  
059 NOC REASON CODE NOT ON FILE Restricted to Comptroller users
060 ACCT TYPE NOT ON FILE Valid values are:
  • 22 = Checking
  • 32 = Savings
061 DUPLICATE NOC System–generated and for Comptroller use only
062 PROTECTED – NO CHANGES ALLOWED System–generated
063 BANK INFO=EXISTING
INFO – NO CHANGE		 If a direct deposit change is attempted with the same information already on file, no changes are made to the direct deposit mail code.
098 DUPLICATE TRANSACTION WITHIN SAME INPUT FILE When a duplicate transaction is submitted within the same input file, one error-free transaction will process; the duplicate transaction will unprocess with error code 098.
100 MAIL CODE ALREADY EXISTS FOR THIS TIN  
101 MAIL CODE FOR THIS TIN NOT FOUND ON FILE

A mail code change or a direct deposit setup may be attempted for a mail code that has not yet been set up for the TIN.

If the requested mail code information is not already on file, it may require a new mail code setup as follows:

  • PMCTUP online update screen
  • T-code 650 for batch
102 NAME REQUIRED FOR MAIL CODE SETUP  
104 ADDRESS INFORATION MUST BEGIN ON FIRST ADDRESS LINE Online =‘Line 1’ field
Batch =‘Supplemental–1’ field
107 CITY MUST BE ENTERED  
108 ZIP CODE IS REQUIRED FOR STATE ENTERED  
109 ZONE CODE/ZIP CODE COMBINATION NOT VALID  
110 ZIP CODE NOT FOUND  
111 STATE/ZIP CODE COMBINATION NOT VALID  
112 WARNING – ZONE CODE CHANGED TO MATCH ZIP CODE  
113 ZIP CODE MUST BE 5 DIGITS  
114 ZIP CODE EXTENSION MUST BE 4 DIGITS If entered or submitted; optional field
115 ZONE CODE MUST BE 3 DIGITS
  • If entered online; optional online field
  • Required for Batch transactions
See Zone Codes for American and Foreign Territories
116 MAIL CODE MUST BE IN FORMAT “NNN” OR “ANN”  
117 ZONE CODE MUST BE ENTERED

Required for Batch transactions

See Zone Codes for American and Foreign Territories
118 VALID STATE ABBREVIATION OR “– –” MUST BE ENTERED  
119 SUPPLEMENTAL ADDRESS LINES MUST BE ENTERED INCLUSIVELY  
120 SETUP DISALLOWED – MAIL CODE RESERVED BY USPS/SPRS  
121 STATE IS INVALID  
122 CITY IS INVALID  
123 CITY/ZIP CODE COMBINATION NOT VALID  
124 EMPLOYING AGENCY NUMBER DOES NOT EXIST  
125 EMP AGY IS ONLY VALID FOR OWNERSHIP TYPE E–EMPLOYEE  
200 HOLD SOURCE MUST BE NUMERIC  
201 HOLD REASON MUST BE NUMERIC  
202 AMOUNT MUST BE NUMERIC  
204 AMOUNT MUST BE IN DECIMAL FORMAT (999.99)  
205 HOLD ALREADY EXISTS FOR THIS NUMBER, SOURCE AND REASON  
206 HOLD DOES NOT EXIST FOR THIS NUMBER, SOURCE AND REASON  
207 SOURCE/REASON COMBINATION IS INVALID  
208 HOLD NAME MUST BE ENTERED  
209 AMOUNT MUST BE ENTERED  
210 HOLD DATE MUST BE ENTERED  
211 INVALID DATE OR FORMAT (MMDDCCYY OR MM/DD/CCYY)  
212 PAYEE HOLD NUMBER MUST BE NUMERIC  
213 LIABILITY AMOUNT MUST BE GREATER THAN ZERO  
214 LIABILITY AMOUNT SAME AS EXISTING AMOUNT  
300 DIRECT DEPOSIT INFORMATION ALREADY EXISTS FOR MAIL CODE SPECIFIED

Verify if the direct deposit information entered or submitted is the same as the information on file for that mail code. If different, resubmit the information as follows:

  • PDDSUP online screen
  • Batch T-code 660

Set up direct deposit on a different mail code:

  • PDDCHG online screen
  • Batch T-codes 661, 662 and/or 663
Change direct deposit on the same mail code:
301 PAYEE IS ON HOLD AND CANNOT BE SET UP FOR DIRECT DEPOSIT The payee is on hold for delinquent child support (Hold Source 302, Hold Reason 350).
302 INPUT SOURCE MUST BE ENTERED Online error message only displays to Comptroller users; the field defaults to an agency user’s security agency.
303 INVALID INPUT SOURCE Online error message only displays to Comptroller users; the field defaults to an agency user’s security agency.
304 INPUT SOURCE MUST MATCH EMPLOYING AGENCY  
305 DIRECT DEPOSIT INFO DOES NOT EXIST FOR MAIL CODE/INPUT SOURCE SPECIFIED  
306 BANK TRANSIT CODE MUST BE ENTERED  
307 CHECK DIGIT IS INCORRECT FOR BANK TRANSIT CODE See Check Digit for Bank Transit Code (login required)
308 INVALID BANK TRANSIT CODE See Financial Institution Information (BANKIN)
309 BANK ACCOUNT NUMBER MUST BE ENTERED  
310 ACCOUNT TYPE MUST BE “22” OR “32”  
312 INPUT SOURCE IS NOT A VALID AGENCY NUMBER Field for valid agency number is validated against the USAS D02 Agency Profile
313 BANK ACCOUNT TYPE MUST BE ENTERED Valid values are:
  • 22 = Checking
  • 32 = Savings
314 MASTER LEVEL INFO FOR PAYEE TO BE MERGED ‘FROM’ DOES NOT EXIST Restricted to Comptroller users
315 MASTER LEVEL INFO FOR PAYEE TO BE MERGED ‘TO’ DOES NOT EXIST Restricted to Comptroller users
316 OWNER INFO FOR PAYEE TO BE MERGED ‘TO’ DOES NOT EXIST Restricted to Comptroller users
317 PARTNER INFO FOR PAYEE TO BE MERGED ‘TO’DOES NOT EXIST Restricted to Comptroller users
318 CHARTER INFO FOR PAYEE TO BE MERGED ‘TO’ DOES NOT EXIST Restricted to Comptroller users
319 OWNERSHIP TYPES ARE NOT THE SAME Restricted to Comptroller users
320 MASTER STATUS IS NOT THE SAME Restricted to Comptroller users
321 BOTH PAYEES HAVE MULTIPLE MAIL CODES Restricted to Comptroller users
322 DUPLICATE MAIL CODE HAS DIRECT DEPOSIT INFO Restricted to Comptroller users
323 MORE THAN ONE MAIL CODE FOR SUPPL INFO; PAYEE IS ALLOWED ONLY ONE Restricted to Comptroller users
324 MORE THAN ONE MAIL CODE FOR WARRANT HOLD; PAYEE IS ALLOWED ONE Restricted to Comptroller users
325 MORE THAN ONE MAIL CODE FOR SUMMARY PAYMENT; PAYEE IS ALLOWED ONE Restricted to Comptroller users
326 WARRANT HOLD INFO ALREADY EXISTS ON PAYEE TO BE MERGED ‘TO’ Restricted to Comptroller users
327 ASSIGNOR INFO ALREADY EXISTS ON PAYEE TO BE MERGED ‘TO’ Restricted to Comptroller users
328 ASSIGNEE INFO ALREADY EXISTS ON PAYEE TO BE MERGED ‘TO’ Restricted to Comptroller users
329 MORE THAN ONE MAIL CODE FOR ASSIGNOR; PAYEE IS ALLOWED ONE Restricted to Comptroller users
330 MORE THAN ONE MAIL CODE FOR ASSIGNEE; PAYEE IS ALLOWED ONE Restricted to Comptroller users
331 MORE THAN ONE MAIL CODE FOR SUSPENSE; PAYEE IS ALLOWED ONE Restricted to Comptroller users
332 MORE THAN ONE MAIL CODE FOR MAINTENANCE HISTORY; PAYEE IS ALLOWED ONE Restricted to Comptroller users
333 TIN TO BE MERGED INFO IS TEMPORARY; MERGE CANCELED Restricted to Comptroller users
334 OLD TIN PAYEE HOLD REASON AND SOURCE EXIST FOR NEW TIN; MERGE CANCELED Restricted to Comptroller users
335 BANK ACCOUNT NUMBER CANNOT CONTAIN “.”  
336 BLANK DATA IS NOT ALLOWED IN THIS FIELD  
337 BANK ACCT NO. IS SAME AS EXISTING BANK ACCT NO – CHANGE NOT ALLOWED  
338 BANK TYPE IS SAME AS EXISTING BANK TYPE – CHANGE NOT ALLOWED  
339 ROUTING NO. IS SAME AS EXISTING ROUTING NO – CHANGE NOT ALLOWED  
340 BANK ACCOUNT NUMBER CANNOT CONTAIN HYPHEN (“—”)  
341 PAYEE HOLD ADDRESSES REQUIRE AN ADDRESS, CITY, STATE AND ZIP CODE  
342 ADDRESS INFO MUST BEGIN WITH A–Z OR 0–1  
343 HOLD DATE MUST BE A CURRENT OR PAST DATE  
344 INVALID DATE OR FORMAT (MMDDCCYY)  
345 FOREIGN ADDRESS REQUIRES ADDRESS=NON–BLANK, CITY=COUNTRY & STATE=“– –“ NO ZIP
500 INVALID ADDRESS INFO  
501 FIRST CHARACTER OF ADDRESS CANNOT BE DASH  
502 FIRST CHARACTER OF ADDRESS CANNOT BE ASTERISK  
503 APARTMENT/SUITE NUMBER MISSING  
504 INSUFFICIENT/MISSING ADDRESS INFO  
505 INVALID STREET NAME INFO  
506 HOUSE NUMBER/STREET NAME OR BOX NUMBER INVALID  
507 INVALID/MISSING STREET SUFFIX (STREET, ROAD, COURT)  
508 INVALID/MISSING STREET DIRECTIONAL (N, E, SW)  
509 VALID ADDRESS REQUIRED TO SET UP MAIL CODE OR CHANGE ADDRESS  
510 FIRST TWO CHARACTERS OF ADDRESS CANNOT BE ASTERISKS  
511 INVALID ZIP CODE  
512 OVRD ERROR – MUST ENTER CITY/STATE/ZIP  
513 OVRD ERROR – ZIP CODE MUST BE 5 DIGITS  
514 OVRD ERROR – ZIP+4 MUST BE 4 DIGITS  
515 OVRD ERROR – ENTER ZONE CODE – CANNOT AUTO–POPULATE  
516 FOREIGN MILITARY ADDRESS, CITY, STATE, ZIP ERROR  
517 FIRST CHARACTER OF ADDRESS CANNOT BE PERCENT SIGN  
518 APARTMENT/SUITE NUMBER INVALID  
550 INVALID ADDRESS INFO  
551 ZIP CODE MODIFIED TO MEET POSTAL STANDARDS OF ZIP+4  
552 ADDRESS ON FILE NOT VALID, PLEASE UPDATE ADDRESS  
553 ADDRESS ALTERED TO MEET POSTAL STANDARDS  
554 APARTMENT/SUITE NUMBER MISSING  
555 APT/SUITE NUMBER MISSING/ADDRESS ALTERED TO MEET POSTAL STANDARDS  
556 APT/SUITE NUMBER MISSING/ZIP+4 MODIFIED TO MEET POSTAL STANDARDS  
700 MASTER SETUP REQUIRED Changes may have been submitted for a TIN / payee not yet set up in TINS. Submit a payee master setup (600) and mail code setup (650).
701 MASTER SETUP REQUIRED Changes may have been submitted for a TIN / payee that was purged or a number change or merge was processed. Submit a payee master setup (600) and mail code setup (650).
702 TIN MUST BEGIN WITH ‘7’

A change transaction to an existing payee TIN, a direct deposit change (661-663) and a direct deposit cancellation (664) all require the ‘7’ TIN and not an SSN- or ITIN-based number prefixed with a ‘2’.

See Payee Number Matrix.
703 TIN MUST NOT BEGIN WITH ‘7’

A new payee setup (600/650) or hold setup (640) may not be submitted with a ‘7’ TIN and requires an SSN- or ITIN-based number prefixed with a ‘2’.

See Payee Number Matrix.
704 TIN MUST BEGIN WITH ‘3’  
705 ENTER ONLY ONE NUMBER
  • Both the sole owner’s SSN and ITIN fields are entered or submitted.
  • More than one of Partner 1 and/or Partner 2 SSN / EIN / ITIN fields are entered or submitted.
706 NUMBER ENTERED IS NOT VALID The SSA or IRS validation criteria is not met for:
  • The online 9-digit SSN, EIN or ITIN or
  • The online 9-digit SSN, EIN or ITIN or
707 TIN ALREADY EXISTS ON FILE  
718 SECURITY TYPE CHANGE NOT ALLOWED See Mail Code Security Levels
719 TIN AND/OR MAIL CODE INACTIVE; NOT ELIGIBLE FOR UPDATES BY EXTERNAL USER Submit a Payee Change Request form (74-157) to Payment Services to request reactivation.
720 ADDRESS VALIDATION FAILED; MAIL CODE CANNOT BE REACTIVATED BY EXTERNAL USER Submit a Payee Change Request form (74-157) to Payment Services to request reactivation and address override.
721 TIN INACTIVE; REACTIVATE ELIGIBLE MAIL CODE OR SET UP NEW MAIL CODE

A mail code is eligible to be reactivated if it was inactivated during the scheduled mail code inactivation ‘cleanup’ process.

For more, see Inactivation Process or ACR 60094.
900 INVALID TCODE See TINS Transaction Codes
901 FIRST DIGIT OF TIN MUST BE ‘2’ OR ‘3’  
902 MASTER ALREADY EXISTS

A new payee setup (600) was submitted for a an existing TIN / payee. Resubmit with the appropriate payee change T-code(s) if the payee record needs updates.

See Batch T-Codes.
903 MASTER DOES NOT EXIST A payee master or mail code change was submitted for a TIN / payee not on file. Submit a payee master setup (600) and mail code setup (650).
904 OWNER NOT FOUND

A change to sole owner information (624, 625) may have been submitted that is not on file. A change of ownership type (623) may be required.

See Ownership Types.
905 PARTNERSHIP NOT FOUND

A change to partnership information (626) may have been submitted that is not on file. A change of ownership type (623) may be required.

See Ownership Types.
906 CHARTER NOT FOUND

A change to the charter number (627) may have been submitted that is not on file. A change of ownership type (623) may be required.

See Ownership Types.
907 UPDATE STATUS TO ‘A’ = ACTIVE TO REACTIVATE/UPDATE MAIL CODE

A mail code is eligible to be reactivated if it was inactivated during the scheduled mail code inactivation ‘cleanup’ process.

For more, see Inactivation Process or ACR 60094.
909 PAYEE NUMBER INACTIVE – UPDATE NOT ALLOWED  
910 MAIL CODE INACTIVE – UPDATE NOT ALLOWED  
911 OWNERSHIP TYPE NOT STATE EMPLOYEE – UPDATE NOT ALLOWED  
912 EMPLOYING AGENCY NOT NUMERIC – UPDATE NOT ALLOWED  
913 MASTER INACTIVE – MAIL CODE SETUP NOT ALLOWED  
914 MAIL CODE CANNOT BE ACTIVATED, NO ACTIVE MASTER Submit a Payee Change Request form (74-157) to Payment Services to request reactivation and address override.
915 SECURING SOURCE DOES NOT MATCH INPUT SOURCE – UPDATES NOT ALLOWED Submit a Payee Change Request form (74-157) to Payment Services to request reactivation and address override.
990 INPUT SOURCE MUST BE NUMERIC  
991 TCODE NOT VALID FOR BATCH PROCESSING See TINS Transaction Codes
992 INVALID FORMAT FOR PHONE NUMBER (9999999999)  
993 VALID MASTER REJECTED BECAUSE OF INVALID OR MISSING MAIL CODE SETUP  
994 MAIL CODE MUST BE NUMERIC  
995 SECURITY VIOLATION  
996 MUST PROVIDE FIRST AND SECOND PARTNERS’ NAMES AND SSN/EIN/ITIN FOR PARTNERSHIP See Ownership Types for Ownership Type ‘P’
997 MUST PROVIDE TEXAS CHARTER NUMBER FOR A CORPORATION See Ownership Types for Ownership Type ‘C’
998 MUST PROVIDE OWNER’S NAME AND SSN/ITIN FOR SOLE OWNER See Ownership Types for Ownership Type ‘S’
999 MORE THAN 4 ERRORS EXIST  
  AMOUNT FIELD CONTAINS NON–NUMERIC CHARACTERS PAYVEN menu
  VARIANCE FIELD CONTAINS NON–NUMERIC CHARACTERS PAYVEN menu
  PHDSUPM1 0063 NAT1100 Input value for a numeric field is not numeric. PHDSUP amount field