ICVerify Interface CCUDM.EXE
Version 2.03

Last edited: December 15, 2003 08:07 AM

CCUDM is run as a shell from Touchnet and is designed to pass data from Touchnet to ICVerify, wait for a response, and then pass the result back to Touchnet.  It’s exact operation is determined by the value in the Branch variable.
Branch Variable
0 Authorize swiped credit card
1 Authorize manual entry
2 Force authorization
3 Add tip to previously transaction
4 Reauthorize/Void

The action performed is dependent on the value of the Amount variable. If the value is greater than 0 then CCUDM will transmit two requests to ICVERIFY – a void and a request for authorization. CCUDM will only return the ICVERIFY’s answer for the request for authorization. If the value is 0 then CCUDM will transmit only the void  to ICVERIFY.  CCUDM will return ICVERIFY’s answer for the void. In both cases, Dollar 3 must contain the value of the previous authorization.

NOTE:
All applications styled before 7/26/95 used the following values to determine the card type and to tell CCUDM how much of the swipe to take for the account number.  This is no longer necessary, and CCUDM has maintained backward compatibility for the applications that are styled this way.  No styling changes are necessary.
14 Authorize swiped 14 digit card(Diners Club,Carte Blanche)
15 Authorize swiped 15 digit card(American Express)
Read from Touchnet

Variable Name 
Contents
Server Name Server name
Amount Credit card amount not including tip
Branch Type of transaction
Chk Num Check number
Dollar 3 Amount of previous authorization
Gratuity Tip amount
Number 3 Expiration Date (branch=1 to 3)
Memo 2 Authorization code (branch=2)
Memo 3 Track 2 of credit card (branch=0)
Memo 3 Credit card number (branch=1 to 3)
NodeName Node name
Written to Touchnet

Variable Name
Contents
Branch 0=Approved
1=Not approved
2=No response
Number 3 Expiration Date
Memo 1 Card Number only
Memo 2 Authorization code or reason for disapproval
Memo 3 Credit card number or Swipe
Revisions

2/2/95

    Added /AUTONUMOFF command line switch to disable creation of CCNODE.DAT file used to automatically number the nodes for ICVerify.  This allows manual creation of the file when the automatic system is not sufficient(i.e. Multiple applications, etc.).

2/14/95

    Corrected bug that prevented the Add Tips function from transmitting the Tip amount.

3/14/95

    Changed no response timeout from 45 seconds to 60 seconds.

4/28/95

    Added ability to read swiped card when account number was less than 16 digits.

6/26/95

    Added ability to define response wait time. At command line use /TIMEOUT=xx where xx is the amount of time to wait.  The default wait time (if /TIMEOUT is not specified) is 60 seconds. If CCUDM does not see the request file when it times out, it will assume that ICVERIFY is running and has picked up the request. At this point CCUDM will continue to wait for the answer file up to 5 times the specified wait time.  Also if CCUDM times out and the request file still exists it will kill the request file so that    ICVERIFY can not pick it up later.

    Added /? command line option to display program information and usage.

6/29/95 Ver 1.31

    Changed to use Server Name variable instead of Employee Name variable.

7/26/95 Ver 1.40

    Changed the way the request file is created for ICVERIFY. Previously the request file was always created in the format that ICVERIFY qualified as a manual entry. Now CCUDM can create different format request files, one for manual entry, and one for a swiped entry. Also changed the styling requirements.  Previously you needed to set Branch to 14 or 15 to tell CCDUM how much of the swipe to take for the account number.  This is no longer necessary.  Backward compatibility is maintained so that no styling changes are necessary to upgrade customers utilizing the old styling requirements.

8/30/95 Ver 1.41

    CCUDM will now return the card number extracted from the swipe in Memo 1 in order to display the card number on the check, instead of the entire swipe which is still stored in Memo 3.

9/08/95 Ver 1.42

    Added error trapping for Swipe/Manual Info in Memo3.  If the length of Memo 3 at time of swapping out to CCUDM is less than 15, (which the length of an AMEX card number, the smallest) then      CCUDM will not produce the REQ file and return only Branch and Memo2 to Z:Variable.TXT. The response will be: “NInvalid Swipe/Manual Information”.

    Brought about by encountering error 5 when a bad swipe was taken and CCUDM was trying to do a MID$ of Info$ (Memo3) (Info$ was blank).

10/10/95 Ver 1.43

    Added more error checking specifically for “INVALID ACCOUNT NUMBER” and “INVALID EXP DATE”.  Previously, CCUDM would always pass back the swipe/account information, this would cause problems because the invalid information is saddled to the check and the user would not know what to do in order to get a good swipe.  Now CCUDM will not pass back the invalid information.  Also re-added a feature that somehow disappeared.

    If CCUDM does not find the node name contained in Z:VARIABLE.TXT in CCNODE.DAT then CCUDM will re-build the CCNODE.DAT file ONCE in case a new node has been added to the network.

10/19/95 Ver 1.44

    Enhanced the error checking of v1.43.  1.43 would not return the bad info if Invalid Account or Exp Date was encountered, however if the shell in Touchnet was set up for storing variables, the bad info would still be stored with the check. V1.44 will now return a null string in place of the bad info.

10/19/95 Ver 1.45

    Further enhanced the error handling.  Also disabled the checking for a minimum of 15 characters in the swipe/manual information string.  Now checks for a minimum of 10.

10/20/95 Ver 1.46

    Fixed a bug in 1.45 that would not return the account information when transaction was approved.

11/15/95 Ver 2.00

    Added /KIOSK command line switch to support Kiosk serial card readers @ COM2.  This was done to accomodate Charlotte Convention Center’s Kiosks.

12/06/95 Ver 2.01

    Fixed bug caused by creating Z:VARIABLE.TXT instead of forcing the root directory Z:VARIABLE.TXT

01/26/96 Ver 2.02

    Added the reauthorize/void ability.  See documentation above re: the Branch variable.

02/06/96 Ver 2.03

    Fixed bug relating to reauthorize/void feature.  Previously this feature would expect swipe information, now it will autodetect whether the information is a swipe or manual.