Set up the Self/Series payment service
Configure the documented Windows server/client workflow and locate the matching Linux package without inventing its installation steps.
Obtain the platform package
The Windows/Linux SDK archives are distributed through the merchant integration resources portal. They contain ChipDNA Server, CLI/GUI samples and release API docs. The public Self/Series walkthrough documents Windows 10/11 with .NET Framework 4.7.2 or later; it does not supply an equivalent Linux service installer or distribution matrix.
Configure the server
In chipdna.config.xml, set an uppercase ApplicationIdentifier, the documented 10-digit device ID and the matching COM port. FileStore, TLS certificate hash and proxy settings are optional deployment-specific additions. Start ChipDNAServer.exe in console mode for development.
Configure a sample client
Set Terminal ID in client.config.xml and the server endpoint; the local default is 127.0.0.1:1869. Launch ChipDNAClient.exe, choose P and enter the transaction details. In this CLI, 123 means 1.23. That integer minor-unit convention must not be copied to Classic form amount fields.
Complete and persist the outcome
The documented flow requires ConfirmTransaction after approved authorization to complete settlement, or VoidTransaction for cancellation before settlement. Keep kiosk fulfillment separate from payment state. If dispensing fails or the service restarts, recover the known attempt instead of initiating a fresh charge.
Prepare a Windows service deployment
Set the correct executable path in service.install.bat, install the service and configure automatic startup only during your approved deployment. For production the guide switches credentials and TMS/registration endpoints; these are separate from app startup. <Tms> <Servers> <Server use="tms"> <Url>https://tms.cardeasexml.com</Url> <Timeout>45000</Timeout> </Server> <Server use="registration"> <Url>https://live.cardeasexml.com/gw.cex</Url> <Timeout>45000</Timeout> </Server> </Servers> </Tms>
Linux implementation boundary
Use the Linux archive and its generated documentation for supported distributions, runtime dependencies, permissions and service startup. Those details are not present in the indexed public guide. This portal does not invent Linux commands or claim that the Windows executable runs on Linux.