Difference between revisions of "CreditLine Text Based / ICVerify Integration"

Revision as of 14:48, 22 February 2006

CreditLine Payment Processing Software Integration. This site can also be reached at http://docs.911software.com

→ Looking for better rates?   Get a Free Credit Card Processing Cost Comparison!

This guide is for developers using the file based communication method. While [API.htm API communication using the DLL ] is the preferred integration method, file based communication is a good alternative that is easy to implement. The format is the same as that of ICVerify.

Directory

Directory for message exchange is [file:///d:/911/messages c:\911\messages]. Directory is configurable through c:\911\data\911_CCV.INI file, see key MessageDir

Protocol Settings

See the following entries in [file:///c:/911/data/911_CCV.INI c:\911\data\911_CCV.INI]

Note: Do not forget to remove ';' in front of a key to uncomment it; for the key to take effect

;********************************************
 ; FILE BASED (ICVERIFY) PROTOCOL SETTINGS
 ;********************************************
 ;
 ;Change the message directory used by the file based ICVerify protocol.
 ;Default: \911\MESSAGES
 ;MessageDir = \911\MESSAGES

 ;Change the file prefix for file based ICVerify messages.
 ;Default: ICVER
 ;ICVerifyMessagePrefix = MSG

 ;Change the type of file base ICVerify reponse for the .ANS file
 ;Default: YES - SET TO NO for VERBOSE
 ;ICVerifyShortResponse = NO

 ;Echo the Request in the .ANS file
 ;Default: NO
 ;ICVerifyEchoRequest=YES

 ;Change the network name used by the server component.
 ;Default: CCV_SRVR
 ;ServerName = CCV_SRVR

 ;********************************************
 ; END FILE BASED (ICVERIFY) PROTOCOL SETTINGS
 ;********************************************

Files

Request file name is ICVER???.REQ (??? is the terminal number)
Response file name is ICVER???.ANS
The prefix for the files is configurable through c:\911\data\911_CCV.INI file, see key ICVerifyMessagePrefix

Request Format

Generic

<Message Type>,<User ID>,<Not Used>,<Account Number>,<Exp Date + Track Data>,<Amount>,<Auth Code + Unique ID>

User ID:
 ???? Employee Number

Exp Date:
yymm Year then month

Amount:
 ?????.?? Authorization Amount

Auth Code:
 ?????? 6 digit auth code

Unique ID:
 ???? 4 digit unique transaction number

Hotel

<Message Type>,<User ID>,<Not Used>,<Account Number>,<Exp Date + Track Data>,<Amount>,<Auth Code + Unique ID>,<Guest Name>,<Checkin Date>,<Checkout Date>,<Room Rate>

Response Format

Approval

<Y + Auth Code + Unique ID>

Decline

<N + Message>

Generic Examples

Auth with Manual Entry:

"CA","0001","","4111111111111111","0212","1.00",""
Note: Employee number is 0001, account number is 4111111111111111, exp date is Dec '02 and auth amount is $1.00.

Auth response with Approval:

"Y1234560001"
Note: Y indicates approval. 123456 is the auth code. 0001 is the returned unique transaction number.
There are no spaces between fields.

Auth with Mag Stripe:

"CA","0001","","4111111111111111","0212B4111111111111111^TEST/CARD^0212201000000","2.00",""
Note: There is no space between exp date and track data.

Auth response with decline:

"NCALL CENTER"
Note: N indicates decline. Show message 'CALL CENTER' to the user.

Force with manual entry:

"C5","0001","","4111111111111111","0212","1.00","123456"
Note: 123456 is the auth code.

Void:

"C2","0001","","4111111111111111","","0.00","0000001234"
Note: 000000 is the auth code filler. 1234 is the unique transaction number.

Edit:

"CT","0001","","4111111111111111","","3.00","0000005678"
Note: 3.00 is the final amount to be sent to the processor.

Hotel Examples

"C4","~ ~PA","040626","37xxxxxxxxxx008","0603","258.00","0402","","Robert Lincoln","20040305","20040306","215.00","","",""

"CO","~ ~LD","040626","37xxxxxxxxxx008","0603","246.3","0402","","Robert Lincoln","20040305","20040306","215.00","","",""

"CO","~ ~KV","040626","37xxxxxxxxxx008","0603","19.37","Z402","","Robert Lincoln","20040305","20040306","0.00","","",""

• "Robert Lincoln" is guest name
• "20040305" is the check in date.
• "20040306" is the check out date.
• "215.00" is the room rate.

Traffic Example

From cs to 911: "CA","0001","","4111111111111111","0212","1.00",""
From 911 to cs: "Y1234561001"
From cs to 911: "CT","0001","","4111111111111111","","3.00","0000001001"
From 911 to cs: "Y1234561001"

for more info please see ICVerify SDK Format Spec