Difference between revisions of "CreditLine Text Based / ICVerify Integration"
m (CreditLine Integration Text Based moved to CreditLine Text Based / ICVerify Integration) |
|
(No difference)
|
Revision as of 14:51, 22 February 2006
This article is part of the Payment Processing Software Library |
|
Get it... | |
Install it... | |
Connect to it... | |
Set it up... | |
Learn to use it... | |
→ Manual & User Guide | |
Fix it... | |
→ Errors & Troubleshooting | |
Get Help... | |
More Info ... | |
See also... | |
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!
Contents
- 1 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.
- 2 Directory
- 3 Protocol Settings
- 4 Files
- 5 Request Format
- 6 Response Format
- 7 Examples
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 Request Format
<Message Type>,<User ID>,<Not Used>,<Account Number>,<Exp Date + Track Data>,<Amount>,<Auth Code + Unique ID>
Message Type | Code |
---|---|
Auth | C1 |
Void | C2 |
Credit/Refund/Return | C3 |
Sale | C4 |
Edit | CT |
Auth Only/Pre-Authorization | CA |
Force/Post-Authorization | C5 |
Finalize: converts Auth to Sale (C + letter "O") | CO |
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 Request Format
<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>
Examples
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.
Complete Turnaround 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