Vx 810 & VX 820 Sentinel Integration Guide
Total Page:16
File Type:pdf, Size:1020Kb
Integration Guide Author: ND Circulation: Public Date: 22/02/2013 Vx 810 and VX 820 Sentinel Author Document name Public ND Vx 810 & VX 820 Sentinel Integration Guide Date 22nd February 2013 Phone Page number Version 08444 828 200 2 V1.16 Revision History Ver. Name Date Comments 1.16 ND Feb 2013 - Updated documentation in-line with solution re- brand - On Hold Transaction functionality detailed - Updated Error Codes table with new error code (-185) - Updated M-Voucher Response record with the 8th field - Added note in Receipt Printing for Screenless mode - Updated CARDWAIT socket connection detail - Removed superfluous fields from L2 Record - Added Transaction Response Versions 7 & 8 1.15 ND Oct 2012 - Reformatted the document - Added detail to ‘Recovered Transaction’ (0040) modifier - CARDWAIT functionality added - Fexco DCC receipt examples added - Updated Transaction Response results with ‘8’ (‘Comms Down’) - Automatic Return Online Functionality detailed - Bill Lodging removed 1.14 ND April 2012 - Pennies XML receipt information documented - Updated document with the new format - WebCom Test URL updated - Updated error codes list - DCC fields in Transaction Response (Version 2) table updated Introduction This document has been produced to provide merchants, Point of Sale solution providers and other system integrators with the information necessary to integrate to the Vx 810 and VX 820 Sentinel solution. Information about the product, background information on VeriFone and all integration messages are included. For step-by-step instructions on installing the product, please refer to the Vx 810 and VX 820 Sentinel Installation Guide. Copyright © 2013 VeriFone All rights reserved. Copying and/or redistribution of this information in whole or in part without the express permission of VeriFone prohibited. Author Document name Public ND Vx 810 & VX 820 Sentinel Integration Guide Date 22nd February 2013 Phone Page number Version 08444 828 200 3 V1.16 Content Revision History ......................................................................................................................... 2 Introduction ................................................................................................................................ 2 1. Solution Overview .................................................................................................................. 7 1.1. Sentinel Software ....................................................................................................... 7 1.2. Supported PEDs ......................................................................................................... 8 1.2.1. Vx 810 ....................................................................................................................... 8 1.2.2. VX 820 ...................................................................................................................... 9 1.3. Operation Modes ...................................................................................................... 10 1.3.1. Screenless .............................................................................................................. 10 1.3.2. Semi Attended ........................................................................................................ 11 1.4. Backward Compatibility ............................................................................................ 11 1.4.1. Removed Features.................................................................................................. 11 1.5. PCI DSS Compliance ............................................................................................... 12 2. Solution Management .......................................................................................................... 13 2.1. EFT Merchant Account ............................................................................................. 13 2.2. Merchant Stores ....................................................................................................... 13 2.3. Testing Procedures .................................................................................................. 13 3. EFT Transaction Types ........................................................................................................ 14 3.1. Customer Present ..................................................................................................... 14 3.2. Customer Not Present .............................................................................................. 14 3.2.1. Account On File Transactions ................................................................................. 15 4. Integration ............................................................................................................................ 18 4.1. Integration Process ................................................................................................... 18 4.2. Testing Values .......................................................................................................... 18 4.3. Integration Methods .................................................................................................. 19 4.3.1. Socket Connection .................................................................................................. 19 4.3.2. Text File .................................................................................................................. 19 4.4. Integration Version ................................................................................................... 20 4.5. Ocius.ini File ............................................................................................................. 21 4.6. Receipt Printing ........................................................................................................ 23 4.6.1. Text File .................................................................................................................. 23 4.6.2. XML File .................................................................................................................. 24 Copyright © 2013 VeriFone All rights reserved. Copying and/or redistribution of this information in whole or in part without the express permission of VeriFone prohibited. Author Document name Public ND Vx 810 & VX 820 Sentinel Integration Guide Date 22nd February 2013 Phone Page number Version 08444 828 200 4 V1.16 4.6.3. Screenless Re-Print ................................................................................................ 26 4.6.1. Receipt Format – XML Mapping .............................................................................. 27 4.6.1. Dynamic Currency Conversion (DCC) ..................................................................... 38 4.6.2. Barclaycard Gift ...................................................................................................... 41 4.6.3. Transax SV ............................................................................................................. 43 4.6.4. Pennies ................................................................................................................... 44 4.7. Integration Messages ............................................................................................... 48 4.7.1. Transaction Request (T Record) ............................................................................. 48 4.7.2. Transaction Response (Initial) ................................................................................. 50 4.7.3. Transaction Response (Version2) ........................................................................... 51 4.7.4. Transaction Response (Version3) ........................................................................... 52 4.7.5. Transaction Response (Version4) ........................................................................... 52 4.7.6. Transaction Response (Version5) ........................................................................... 52 4.7.7. Transaction Response (Version6) ........................................................................... 52 4.7.8. Transaction Response (Version7) ........................................................................... 52 4.7.9. Transaction Response (Version8) ........................................................................... 52 4.7.10. Login Request (L2 Record) ................................................................................... 54 4.7.11. Logout Request (O Record) .................................................................................. 56 4.7.12. POS Progress/Customer Facing ........................................................................... 56 4.7.13. Continue Transaction (CONTTXN Record) ........................................................... 63 4.7.14. Transaction Value Modification ............................................................................. 66 4.7.15. REQINFO.............................................................................................................. 69 4.7.16. Additional Integration Commands ......................................................................... 70 5. Value Added Services .......................................................................................................... 72 5.1. Barclaycard Gift ........................................................................................................ 72 5.2. Barclaycard Gift Request (BGIFT Record) ...............................................................