PosXML Client C# - XML based communication protocol over HTTP

1.2 Terms iCPT - Ingenico Card Payment Terminal PosXML - XML module for POS systems PosXML Client - client program Client card - a card used for client identification Payment Card - electronic payment card 2. Conception 2.1 General The most important feature of PosXML is the possibility to perform electronic payments via direct Internet connection instead of dial-up. PosXML Client is a sample program which takes advantage of XML based communication protocol over HTTP. 2.2 HTTP sessions iCPT supports only XML UTF-8 encoding. PosXML Client initiates every operation (e.g. an electronic card payment) with a specific XML message and iCPT responds with corresponding response message (also XML). The Response message contains a result code of the operation (and may also contain other information). Typical steps of electronic card payment using PosXML are shown below. 1. Client initiates connection to iCPT 2. Client sends request: http/1.0 content-length: 185 content-type: text/xml <?xml version="1.0" encoding="UTF-8" ?> <PosXML version="7.2.0"> <TransactionRequest> <Amount>10000</Amount> <CurrencyName>EUR</CurrencyName> </TransactionRequest> </PosXML> 3. After successful transaction iCPT sends response: http/1.0 200 ok content-length: 1608 content-type: text/xml <?xml version="1.0" encoding="UTF-8" ?> <PosXML version="7.2.0"> <TransactionResponse> <ReturnCode>0</ReturnCode> <Reason></Reason> <TransactionData> <Amount>10000</Amount> <AdditionalAmount>0</AdditionalAmount> <CurrencyName>EUR</CurrencyName> <DateTime>24.03.2010 10:21:56</DateTime> etc.... all documentation provided. 4. If iCPT is configured to support XML session then iCPT closes connection, otherwise connection remains open until client closes it. If PosXML receives an unknown message or detects a wrong message version, it responds with XML answer Error, described in 3.5.28