open source · windows · payment integration

Connect the till, run payments safely.

A native Windows gateway between ZVT 13.13 and SumUp. For till integrations over TCP or COM, with controlled payment flows and locally protected credentials.

v1.0.1MIT

zvt2sumup · overview
ZVT2SumUp overview showing the status of the Windows service, gateway, till, SumUp terminal and local transaction journal

why

Two protocol worlds, one controlled payment flow.

ZVT2SumUp accepts ZVT commands from a till, translates supported operations into the SumUp API and maps the result deterministically back to the till protocol.

The desktop app, Windows service and diagnostic tools use the same gateway engine. The self-contained build needs no separate .NET installation.

in use

Status, diagnostics and service operation in one native interface.

Diagnostics run without a payment. The till simulator makes ZVT responses visible.

zvt2sumup · diagnostics
Safe diagnostics view of ZVT2SumUp with SumUp connection test, till simulator, COM port detection and gateway simulator
Diagnostics without payment · secrets and payment data hidden
zvt2sumup · simulator
Interactive ZVT2SumUp till simulator with ZVT 13.13 commands and clear warnings about operations with real-world effect
Interactive ZVT 13.13 till simulator · real-world effect clearly marked

features

For real interfaces, with safe boundaries.

[01]

ZVT 13.13

Native implementation of PA00P015 revision 13.13 with KORONA-compatible RAW APDUs and length-based framing.

[02]

SumUp bridge

Payment, reversal, full or partial refund, status, end-of-day closing and terminal pairing.

[03]

TCP and COM

Loopback as the safe TCP default, several controlled clients and serial operation with DLE escaping and LRC checking.

[04]

Payment safety

Integer cents, no automatic POST retries and explicit confirmation for operations with real financial effect.

[05]

Protected secrets

API and affiliate keys are protected with Windows DPAPI; sensitive values are stripped from errors and logs.

[06]

Verified releases

Manual updates verify HTTPS sources, SHA-256 manifest, EXE versions and smoke tests, with two-file rollback.

test safely

Simulate first, then execute deliberately.

The bundled till simulator makes ZVT responses visible without triggering a payment.

Real payments, refunds and end-of-day closings require separate, explicit confirmations.

technical data

Native Windows, traceable payments.

Runtime
.NET 10 · self-contained
UI
Windows Forms
Protocol
ZVT 13.13 · TCP · COM
Secret protection
Windows DPAPI
Tests
42 deterministic · no real payment
License
MIT
oe@xyz ~ zvt2sumup

$ git clone zvt2sumup

Source code, compatibility matrix, security model, SHA-256 checksums and releases are publicly available on GitHub.

GitHub repository ↗

ZVT2SumUp is an independent project and is neither operated nor officially supported by SumUp or KORONA.