Skip to Content

Vending Machine Integrations & API Everything connected.

Control the terminal from your own software, ask your AI about your vending machines, connect it directly to your vending machine, or process payments from your own POS system. The SENVEND Payment Terminal and my.SENVEND integrate with the systems you already use.

AI assistant · MCP Cloud API · soon Software · gRPC Machine · MDB POS · ZVT

Software integration · gRPC API

Program your terminal.

With the SENVEND API, your own software controls the Payment Terminal directly on your local network: start payments, verify age, dispense products via MDB. Sales show up in my.SENVEND as usual.

Payment trace with age verification

  1. Software · Start · +0.00 s{"start": {"amount": 100, "age_verification": {"min_age": 18}}}Charge €1.00, but verify age 18+ first.
  2. Terminal · Age verification · +0.05 sageApiSuccess: VERIFICATION_STARTEDCustomer chooses their proof of age.
  3. Terminal · Age confirmed · +6.40 s{"ageSuccess": {}}Age verified.
  4. Terminal · Payment · +6.42 sapiSuccess: PAYMENT_STARTEDCustomer presents their card.
  5. Terminal · Approval · +9.10 s{"approved": {"amount": 100}}Paid: €1.00.
  6. Software · Goods issued · +11.30 s{"goods_issued": {}}Product dispensed.
  7. Terminal · Confirmation · +11.31 sapiSuccess: GOODS_ISSUED_ACCEPTEDGot it.
  8. Terminal · Completion · +11.35 s{"success": {}}Process complete.

Simplified: process IDs are omitted, status messages are shortened, and the timings are illustrative.

  • Payments

    Start a payment, adjust the amount until it’s approved, and report cash for your analytics.

  • Age Verification

    On its own or before payment. Your customer chooses from all configured methods on the terminal.

  • Product dispensing

    Your software dispenses products through the connected MDB vending machine, one at a time or as a list.

  • Soon

    Cloud API

    The same flows over the internet, without a local network. The definitions are already on GitHub.

Open on GitHub Proto definitions, docs with example flows, and example clients for Rust, Python, Kotlin and C#. Ready-made packages are available on crates.io, PyPI, Maven Central and NuGet.

AI integration · MCP

Just ask your machines.

Using MCP, the open standard for connecting AI assistants, you can connect an assistant such as Claude or ChatGPT to my.SENVEND. Sign in with your my.SENVEND account—no API key required.

  • Read only
  • Only your data
  • Claude & Co.
  • Access included

Example questions

  • “Which machines are almost empty right now?”
  • “Which products sell well at the train station but not at all on campus?”

More data. More possibilities.

Through the MCP integration, your AI can also query and combine data that isn’t directly available in the my.SENVEND interface. Your user permissions still apply.

Note

You’ll need your own account with an AI service such as Claude or ChatGPT. Depending on your plan, fees may apply.

Telemetry

View examples

Six use cases, each with a possible conversation with your AI: Compare locations Reconcile cash Evaluate pricing Find outages Spot slow sellers Plan a new machine

Vending machine integration · MDB

The standard in the machine.

Your vending machine uses MDB to communicate with payment devices such as coin changers, bill validators and card terminals. We document how the SENVEND Payment Terminal works with MDB on GitHub—for vending machine manufacturers and integrators.

Vending transaction trace

  1. Machine · Vend Request · +0.00 s13 00 00 64 00 01Slot 1 selected, €1.00. Requesting payment.
  2. Terminal · ACK · +0.01 s00Got it.
  3. Terminal · Vend Approved · +2.41 s05 00 64Payment approved. Dispense the product.
  4. Machine · ACK · +2.41 s00OK.
  5. Machine · Vend Success · +4.02 s13 02 00 01Product dispensed.
  6. Terminal · ACK · +4.02 s00Got it.
  7. Machine · Session Complete · +4.20 s13 04Session ended.
  8. Terminal · ACK · +4.20 s00All set.

Simplified: polling (POLL) and checksums are omitted. Timings are illustrative.

  • Card payment (cashless)

    How the terminal operates as a cashless payment device in a vending machine.

  • Age Verification

    How age verification and the vending machine interact via MDB.

  • Age Verification Device

    How the terminal connects as a separate Age Verification Device on the MDB bus.

Open on GitHub The complete MDB documentation is available on GitHub. Missing something? Issues and pull requests are welcome.

MDB adapter · Hardware

One adapter. All connected.

The SENVEND MDB adapter connects the terminal, vending machine and cash-handling devices. It ensures reliable communication and enables integration even where it was difficult before.

SENVEND UX700USB-C2-PINMACHINEDEVICESMDB adapterVending machine (VMC)Cash devices1234
  1. 1USB cable from the terminal to the adapter
  2. 2Power cable from the terminal to the adapter
  3. 3Vending machine on the right MDB port
  4. 4Cash-handling devices on the left MDB port
Top view of the SENVEND MDB adapter circuit board: USB-C connector and two-pin power connector on the left, RP2350 microcontroller in the middle, and two MDB sockets on the right.
  1. AUSB-C: data to the terminal
  2. BPower from the terminal (2-pin)
  3. CRP2350: Raspberry Pi microcontroller
  4. DMDB sockets: vending machine and cash-handling devices

The device itself: MDB adapter in the hardware overview

  • Stable connection

    Card payments and age verification work more reliably with the vending machine, even with machines that otherwise cause problems.

  • Cash payments keep working

    Coin changers and bill validators connect to the adapter and continue working as before.

  • No separate power supply

    Power comes from the terminal’s MDB port, and data is transferred via USB-C. The adapter cables are included; you’ll only need a USB-A to USB-C cable.

Soon

Master Telemetry

Master Telemetry will also be available through the adapter soon.

POS integration · ZVT

Your POS. Our terminal.

Do you have your own POS system or payment station? Using ZVT, the German standard for payment terminal connections, it can process card payments through the SENVEND Payment Terminal. Our ZVT proxy handles the connection.

Card payment trace

  1. POS · Authorization · +0.00 s06 01 07 04 00 00 00 00 01 00Please charge €1.00.
  2. Terminal · ACK · +0.02 s80 00 00Got it.
  3. Terminal · Intermediate status · +1.84 s04 FF 01 0ACustomer presents their card.
  4. POS · ACK · +1.85 s80 00 00OK.
  5. Terminal · Status information · +3.91 s04 0F …Payment complete. Here are the receipt details.
  6. POS · ACK · +3.92 s80 00 00Received.
  7. Terminal · Completion · +4.11 s06 0F 00Done.
  8. POS · ACK · +4.11 s80 00 00All set.

Simplified: the intermediary ZVT proxy is omitted, and the timings are illustrative.

  • ZVT proxy

    Your POS system connects to SENVEND over TCP (port 20000), not directly to the terminal.

  • Forwarded requests

    The proxy forwards payment, refund, diagnostic and abort requests. SENVEND handles age-verification and language requests directly.

  • Set up together

    SENVEND assigns the terminal ID. Contact us at api@senvend.com, and we’ll set up the integration with you.

Open on GitHub Documentation and the zvt_cli test tool for Linux and Windows are available on GitHub. Missing something? Issues and pull requests are welcome.

FAQ

Integrations in a nutshell.

What can the API do?

Your software starts payments, age verifications and product dispensing via MDB over your local network, directly on the SENVEND Payment Terminal. Sales show up in my.SENVEND as usual. A cloud API for access over the internet is coming.

What does the AI integration cost?

Nothing extra. The AI integration (MCP) is included in SENVEND Telemetry . You’ll need your own account with an AI service such as Claude or ChatGPT. Depending on your plan, fees may apply.

Do I need programming skills?

Not for AI integration: enter the URL, sign in with your my.SENVEND account, and you’re done. The API is aimed at developers. For ZVT and MDB connections, we work with your POS or vending machine technician to set everything up.

Can the AI change anything on my machines?

No. AI integration is read-only. You can still only restart terminals, dispense products or add credit directly in my.SENVEND.

Which AI assistants are supported?

Any assistant that supports MCP. Step-by-step guides for Claude and ChatGPT are available in the AI integration Help Center.

What happens to my data?

You can access only your company’s data, with the same permissions as in my.SENVEND. Your AI provider, such as Anthropic or OpenAI, processes your questions and the resulting answers under its own privacy policy. You decide what to ask.

Do I need the MDB adapter?

Not always. With many vending machines, the terminal connects directly via MDB. With others, the adapter improves reliability—or makes the connection possible in the first place. Your reseller can advise whether you need one.

What do the POS and MDB integrations cost?

That depends on your project. Write to us at api@senvend.com, and we’ll send you a quote.

Ready to connect?

New to SENVEND

Explore our packages and pricing.

View packages

Already a customer?

Connect my.SENVEND to your AI assistant and just start asking.

Go to my.SENVEND

Planning an integration?

Tell us about your project and we’ll find the right approach with you.

Discuss your project

Any questions? We’re here for you.

+49 231 4499210 help@senvend.com +49 1579 2451201 Contact us