SecureNet Gateway Implementation Guide 4.1.5
APPENDIX C: REFERENCES
A. Introduction
The Valutec WS is a standard web service as defined by World Wide Web Consortium (W3C, http://www.w3.org).
It provides several methods that the programs and web applications can use to process transactions, provide reports, and update customer information on Valutec gift and loyalty cards.
If not familiar with web services, examine the following resources:
For an overview of web services and related technology: http://en.wikipedia.org/wiki/Web_service
For an introduction to XML, the foundation for both SOAP & WSDL: http://www.w3schools.com/xml/default.asp
For a tutorial on SOAP, the communication language of web services: http://www.w3schools.com/soap/default.asp
For a tutorial on WSDL, the language that web services use: http://www.w3schools.com/wsdl/default.asp a. Automatic Discovery and Code Generation
The code documents itself in a form that is machine readable, using WSDL. You can obtain the WSDL definition of this web service with the links provided for the appropriate service.
Many Java and .NET development environments include or have available tools that can read this WSDL and automatically generate a set of classes that encapsulate all the details of interacting with the web service. You can then use the web service via these wrapper classes without needing to deal with any of the WSDL, SOAP, HTTP, or network communications details. After the wrapper classes have been generated, the only code that needs to be written is to instantiate the wrapper and call the approprithete transaction method on it. Only 1 or 2 lines of code will be required to be written (thanks to the hundreds of lines that were already automatically generated).
If these web services tools are available, there only two things that need to be known in order to start using this web service:
1. How to use web service tools
2. The WSDL URL for this web service
NOTE: The names of some web methods may be modified by existing tools in order to follow naming conventions or avoid the illegal use of keywords in the programming language. For example, in Java and other languages the void(...) web method may be renamed to _void(...) or some other variation because void is a language keyword.
If these web services tools are not available, then use one of the other options:
If comfortable with SOAP, use the SOAP 1.1 or SOAP 1.2 interfaces. The documentation for each web method (links provided below) contains sample SOAP 1.1 and 1.2 request/response pairs. Note that each sample shows the entire HTTP/S message including header fields and content.
― Production SOAP URLs
https://gateway.securenet.com/API/Gateway.svc/soap , for Transaction API (Gateway services)
https://gateway.securenet.com/API/data/service.svc/soap , Extended Transaction Functionality
API (Extended services)
https://gateway.securenet.com/API/data/transaction.svc/soap , for Extended Transaction
Process API (Transaction services)
92
SecureNet Gateway Implementation Guide 4.1.5
― Certification SOAP URLs
https://certify.securenet.com/API/Gateway.svc/soap , for Transaction API (Gateway services)
https://certify.securenet.com/API/data/service.svc/soap , for Extended Transaction Functionality
API (Extended services)
https://certify.securenet.com/API/data/transaction.svc/soap , for Extended Transaction Process
API (Transaction services)
Use the HTTP GET interfaces. Sample request/response pairs for this interface are provided with the documentation for each web method. Note that each sample shows the entire HTTP/S message including header fields and content.
If not using tool-generated wrappers, be familiar and comfortable with the libraries for raw TCP/IP and/or
HTTPS communication.
93
SecureNet Gateway Implementation Guide 4.1.5
Revision History
Date Version Revision Description of change(s) Author(s)
12/23/2011 4.1.2
01/11/2012 4.1.2
01/11/2012 4.1.2
01/11/2012 4.1.2
01/11/2012 4.1.2
01/27/2012
5/03/2012
4.1.2
4.1.3
6/21/2012 4.1.3
08/20/2012 4.1.4
08/20/2012 4.1.4
1 Initial
2 Added
2 Added
2 Added
8/22/2012 4.1.4
9/14/2012 4.1.4
4 Formatted/edited new additions. Added Proprietary and
Confidential to cover and footer, updated TOC and version.
4 Revised and updated Hotel Sale Code, Charge Type and
Auto Sale Code. Fixed bookmarked links.
11/27/2012 4.1.4 5 Rearranged per Judi. Narendra updated / revised items identified by Judi.
12/12/12 4.1.5 1 Added
Added ProcessABAccount method in Secion4.3
Added GetABAccount_Ext & GetABAccounts_Ext (overload methods) in Section 4.4
12/31/12 4.1.5 1 Complete
Preetham Gowda, Jorge
Tardio, Narendra Solanki
Narendra Solanki
Narendra Solanki
Narendra Solanki
2 Added Solanki
2 Modified verbiage for REF_TRANSID in Appendix Jorge Tardio, Narendra
Solanki
3 Added to Sections: 8.20.2, 8.20.3 and 8.21.1.1
Added to Appendix A, Section C
Added to Appendix B, Section C
Mukesh Agrawal
3 Revised Section 4.5—Reporting Methods for SecureNet
Vault and AutoBill Services [Extended Services],
GetABAccounts—Method to retrieve all AutoBill accounts of
CustomerID
4 Updated CARDLEVEL_RESULTS values in Appendix A for
MasterCard
4 Revised CARDLEVEL_RESULTS values in Appendix A for
MasterCard
Narendra Solanki
Kathiravan Srinivasan
Narendra Solanki
Cindy Magee
Stella Wateba / Cindy
Magee
Judi / Narendra / Cindy
Narendra Solanki
Preetham Gowda / Stella
Wateba / Judi Seguy
94
