ChipDNA Client & Server Configuration Files

Server

Setting up the chipdna.config.xml file

Below is a sample config which can be copied and edited with the appropriate input. Please review all of the article as more information is provided near the bottom including the appropriate URLs for both our staging and live platform.

<?xml version="1.0" encoding="utf-8"?>
<ChipDnaServer version="1.0.0">
    <MachineName>localhost</MachineName>
    <ApplicationIdentifier>*Insert APP ID*</ApplicationIdentifier>
    <Socket>127.0.0.1:1869</Socket>
    <Terminals>
        <Terminal>
            <TerminalId>*Insert Terminal ID*</TerminalId>
            <TransactionKey>*Insert Transaction Key*</TransactionKey>
            <PaymentDevices>
                <PaymentDevice> 
                    <Model>*Insert Device Model*</Model>
                    <Id>*Insert Serial Number*</Id>
                    <Protocol>*Insert Communication Protocol*</Protocol>
                    <Address>*Insert IP Address(Only used with TCP/IP Protocol)*</Address>
                    <Port>*Insert Port*</Port>
                    <StandbyMessage>Standby Message</StandbyMessage>
                    <Parity>none</Parity>
                    <Stopbits>1</Stopbits>
                    <Databits>8</Databits>
                </PaymentDevice>
            </PaymentDevices>
        </Terminal>
    </Terminals>
    <Tms>
        <Servers>
            <Server>
                <Url>https://testtms.cardeasexml.com</Url>
                <Timeout>45000</Timeout>
            </Server>
        </Servers>
    </Tms>
</ChipDnaServer>

Protocol

This field is populated with the communication protocol the device is using to connect to the server, a list is below:

• Serial (RS-232 & VCOM/USB)
• USBHID
• TCPIP (<Address>xxx.xxx.xxx.xxx</Address> must match the IP address defined in the configuration of your PIN pad)

Port

For Serial, this will be the physical COM port your device is connected to. Otherwise, it will be a virtual COM port which can be found within Device Manager > Ports(COM & LPT) > Select the Payment Device > Port Settings > Advanced... > COM Port Number.

For TCPIP, this is the port your device is connected over.

URL

This URL is dependent on whether you will be connecting to our Test or Live platform.

• Test: https://testtms.cardeasexml.com
• Live: https://tms.cardeasexml.com

Client

Setting up the client.config.xml file (only in our sample Clients)

<?xml version="1.0" encoding="utf-8"?>
<ChipDnaClient version="1.0.0">
 <TerminalId>*Insert Terminal ID*</TerminalId>
 <Server>127.0.0.1:1869</Server>
</ChipDnaClient>

Server

This field should match the IP Address and Port specified in the Socket field of the chipdna.config.xml.