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.