XML Connection Methods
Developers wishing to interface directly with the transaction processing server may do so using XML. Sale requests are posted directly to the processing server via HTTPS, ensuring the security of the submitted information. XML responses are generated during the same connection, reducing the number of connections required to process a transaction.
The XML schema provides an easy alternative for developers wishing to process real-time transactions. Because of the open-architecture of XML, developers may create their own Windows COM objects, Java apps, PHP routines, Perl libraries, standardized Web Services, etc. If your application can generate XML, you can process transactions.
By using XML, you gain extensive control of your transactions. You have the full ability on your end to determine which of your transactions get passed to iTransact for processing and which do not. iTransact will process only the transactions you relay to us – and every transaction you relay to us.
You will therefore want to apply whatever security filters on your end you deem necessary to determine which transactions are legitimate (i.e., not bogus or fraudulent) before relaying them to iTransact for processing.
Since the XML method is simply another method for processing sale transactions, all gateway features remain available. This includes the Virtual Terminal, Transaction Listing, Testing Interface, etc.
For added security, XML capabilities are not immediately activated at the time of your registration. This feature must be enabled by a gateway representative.
XML Interface Modules
- XML API Connection
- All transaction types are supported through this method.
- XMLTRANS (Deprecated)
- Order, Preauth, Force Transactions
A monthly fee of $5.00 is charged for access to the XML Connection Method. This fee is above and beyond your current gateway access fees.
Creating XML Requests
There are certain characters such as "&" and "<" that may not appear in a XML request unless they are part of the actual XML structure. These characters have to be "escaped" by using the forms & and <. More information about XML markup can be found at http://www.w3.org/TR/REC-xml/#syntax.
We suggest that you do not try and create XML structures by simply appending to a string with print statements. Using a XML generation library will ensure that you do not accidently create badly formatted documents due to user input. The disadvantage of using a library is that it will take a little longer to code. If you do not use a library you need to make sure that any XML node text you are adding that is coming from a user gets escaped as described above. If you do not escape these characters you will have transactions occasionally fail due to a bad XML structure.
Here are some suggested XML generation libraries for different development environments. This is by no means an authoritative list and there are other good libraries available.
Please do not hesitate to contact us with any questions.
PO Box 999
314 South 200 West
Farmington UT 84025-0999
Phone: (801) 298-1212
Fax: (801) 298-9789
For technical assistance, please submit a ticket via the iTransact Support Center.