Dokumentation · Benutzerhandbuch

Conversational · Telegram

Akzeptieren Sie Zahlungen direkt in Telegram mit @miaposbot — keine Apps, keine neuen Geräte, kein Verlassen des Gesprächs mit Ihrem Kunden.

ZielgruppeHändler
SchwierigkeitEinsteiger
Aktualisiert30.05.2026

Was es ist und warum

@miaposbot ist der offizielle miaPOS-Bot in Telegram. Sie geben in einem beliebigen Chat einen kurzen Befehl ein (eine Direktnachricht mit einem Kunden, ein Gruppenchat, ein Kanal) — der Kunde erhält eine Bezahlen-Schaltfläche und schließt den Bezahlvorgang über die sichere Seite seiner Bank ab.

Warum es so funktioniert:

  • Der Kunde installiert nichts — es ist die Standard-Bezahlseite seiner Bank.
  • Sie öffnen nichts — alles bleibt in dem Chat, in dem Sie ohnehin schon kommunizieren.
  • Es funktioniert in jedem Telegram-Chat, selbst in einem, in dem der Bot nie hinzugefügt wurde.

Schritt 0 — Einmalige Aktivierung

Sie verknüpfen Ihr Telegram einmalig mit Ihrem Verkäuferkonto. Der Bot wendet sich an das System Ihrer Bank und sucht Sie anhand Ihrer Telefonnummer.

  1. Öffnen Sie den Chat mit @miaposbot und senden Sie /start.
  2. Der Bot zeigt eine Bankenliste — tippen Sie auf Ihre Bank. Wenn Ihr Händler nur mit einer Bank zusammenarbeitet, wird dieser Schritt automatisch übersprungen.
  3. Tippen Sie auf 📞 Telefonnummer teilen und bestätigen Sie im Systemdialog von Telegram.
  4. Fertig — der Bot antwortet „Aktiviert als Verkäufer von [Händlername]“.
Falls der Bot „Telefonnummer nicht gefunden“ meldet — bitten Sie Ihren Manager, Ihre Telefonnummer im Händlerportal hinzuzufügen.

1) Wählen Sie Ihre Bank

Nach /start zeigt der Bot die Bankauswahl:

Bankauswahl nach /start

2) Teilen Sie Ihre Telefonnummer

Nach der Auswahl Ihrer Bank fordert der Bot Sie auf, Ihre Telefonnummer zu teilen:

Begrüßung und Schaltfläche „Telefonnummer teilen“

3) Bestätigen Sie in Telegram

Telegram öffnet seinen Standard-Systemdialog — tippen Sie auf OK:

Telegram-Systemdialog „Telefonnummer teilen“

4) Aktiviert

@miaposbot
  ✅ Aktiviert als Verkäufer von Cafenea SRL.
     Versuchen Sie: @miaposbot 100 Kaffee

Das Hauptszenario — Inline-Modus

Dafür ist der Bot da. Sie geben den Befehl direkt im Chat mit dem Kunden ein (oder in einer Gruppe) — der Bot tritt dem Chat nicht bei, er schlägt Ihnen lediglich die Zahlung vor.

1. Beginnen Sie im Chat mit Ihrem Kunden zu tippen:

@miaposbot 100 Kaffee

2. Eine Zahlungsvorschau erscheint über der Tastatur (nur Sie sehen sie — der Kunde sieht noch nichts):

┌─ @miaposbot Vorschläge ─────────────────┐
│ 💳 100 MDL bezahlen                     │
│    Cafenea SRL · "Kaffee"               │
└─────────────────────────────────────────┘

3. Tippen Sie auf die Vorschau — der Bot sendet eine Zahlungskarte mit einer Bezahlen-Schaltfläche in den Chat:

Sie (via @miaposbot)
  💳 Cafenea SRL
     100 MDL · Kaffee

  [  Bezahlen  ]

4. Der Kunde tippt auf Bezahlen → die sichere Bezahlseite seiner Bank öffnet sich → er bezahlt.

5. Die Karte aktualisiert sich selbst zu ✅ Bezahlt oder ❌ Fehlgeschlagen — niemand muss etwas aktualisieren:

Sie (via @miaposbot)
  ✅ 100 MDL bezahlt
     "Kaffee"

Befehlssyntax

Format:

@miaposbot <Betrag> [Währung] [Beschreibung] [+Telefon | IBAN] [#Tag]
FeldErforderlichBeispiele
Betragja100, 99.50, 10.00
Währungnein (Standard: MDL)EUR, USD, RON
BeschreibungneinKaffee, Tisch 7, Rechnung Mai
+Telefonnein+37368881777Zahlungsanforderung an die Telefonnummer statt eines Links
IBANneinMD24AG000...Zahlungsanforderung an das Konto
#Tagnein#tisch-7, #juni — Ihre eigene Kennzeichnung für Berichte

Beispiele

BefehlWas passiert
@miaposbot 100100 MDL, ohne Beschreibung
@miaposbot 100 Kaffee100 MDL, Beschreibung „Kaffee“
@miaposbot 99.50 EUR Mittagessen99,50 EUR, Beschreibung „Mittagessen“
@miaposbot 250 +37368881777Zahlungsanforderung an +37368881777 senden
@miaposbot 50 Kaffee #tisch-750 MDL + Ihr Tag #tisch-7
Trennzeichen — ein gewöhnliches Leerzeichen. Sie können auch ; verwenden, falls Sie das bevorzugen (@miaposbot 100; Kaffee; #tisch-7).

In Gruppen und Kanälen

Der Inline-Befehl funktioniert in jedem Telegram-Chat, in dem Sie Nachrichten senden können:

  • Eins-zu-eins mit einem Kunden — wie oben beschrieben.
  • Gruppenchat (z. B. ein HoReCa-Bestellchat) — derselbe Ablauf.
  • Kanal, in dem Sie Administrator sind.
Der Bot muss nicht in der Gruppe sein. Er läuft im Gast-Modus (Bot API 10.0) — er liest nichts im Chat, er postet lediglich die Zahlungskarte, die Sie aus der Inline-Vorschau ausgewählt haben.

DM-Spiegel

Jedes Mal, wenn Sie eine Zahlung in einer Gruppe erstellen, sendet Ihnen der Bot eine Kopie als Direktnachricht — so behalten Sie Ihr eigenes Protokoll, auch wenn die Gruppe lebhaft ist:

@miaposbot → Sie als DM
  💳 Zahlung im Inline-Modus erstellt
     100 MDL · "Kaffee"

Der endgültige Status wird ebenfalls in Ihre Direktnachricht gespiegelt.

Zahlungsstatus

Die Zahlungskarte bearbeitet sich selbst im Chat, sobald das Ergebnis eintrifft:

Was Sie sehenWas es bedeutet
💳 + Bezahlen-SchaltflächeWartet darauf, dass der Kunde aktiv wird
BezahltDer Kunde hat bezahlt; die Gutschrift erfolgt nach den Regeln Ihrer Bank
FehlgeschlagenDer Kunde hat abgebrochen oder es ist ein Fehler aufgetreten

Derselbe Status trifft auch in Ihrer Direktnachricht mit dem Bot ein.

Wenn etwas schiefgeht

ProblemLösung
Der Bot antwortet nicht auf /startStellen Sie sicher, dass in Telegram ein Benutzername gesetzt ist (Einstellungen → Benutzername). Der Bot sucht Sie über den @Benutzernamen.
„Telefonnummer nicht gefunden“Ihr Manager muss Ihre Telefonnummer im Händlerportal hinzufügen.
„Dieses Konto ist bereits mit einem anderen Telegram verknüpft“Wenden Sie sich an Ihren Administrator, um die Verknüpfung mit dem alten Telegram aufzuheben.
Die Inline-Vorschau erscheint nichtPrüfen Sie, dass Sie genau @miaposbot (mit dem @) und ein Leerzeichen vor dem Betrag eingegeben haben.
„⚠️ Dienst vorübergehend nicht verfügbar“Warten Sie eine Minute und versuchen Sie es erneut.

FAQ

F: Muss der Kunde etwas installieren?
A: Nein. Er tippt auf Bezahlen und die sichere Bezahlseite seiner Bank öffnet sich — dieselbe Seite, die er bei jeder gewöhnlichen Online-Zahlung sehen würde.

F: Wie verhält es sich mit den Gebühren?
A: Genau die mit Ihrer Bank vereinbarten Konditionen. Der Bot erhebt keine zusätzlichen Gebühren.

F: Wo geht das Geld ein?
A: Auf das Händlerkonto, mit dem Sie registriert sind — gemäß den Regeln Ihrer Bank.

F: Was passiert, wenn die Zahlung durchgeht, aber sich der Status nicht aktualisiert?
A: Die Karte aktualisiert sich automatisch, sobald die Bank bestätigt hat. Sollte etwas hängen — das hat keinen Einfluss auf das Geld; es ist bereits bei der Bank.

F: In welcher Sprache antwortet der Bot?
A: In der Sprache, die in Ihrem Telegram eingestellt ist (RO / RU / EN).

F: Ist es in einem Gruppenchat sicher?
A: Ja. Der Bot läuft im Gast-Modus — er liest keine anderen Nachrichten, er postet nur die Karte, die Sie aus der Inline-Vorschau ausgewählt haben.

Sicherheit

  • Der Bot sieht niemals Kartendaten — der Kunde gibt sie auf der sicheren Seite seiner Bank ein.
  • Der Bot sieht niemals Ihre Passwörter — die Autorisierung erfolgt über Ihre im Händlerportal hinterlegte Telefonnummer.
  • Jede Zahlung läuft über Ihre Bank und wird auf deren Seite signiert — niemand dazwischen kann etwas ändern.

Was der Bot sonst noch kann

Dieser Leitfaden behandelt nur den Inline-Modus. Der Bot hat auch andere Szenarien (direkte Befehle /pay und /rtp im DM, Verlauf und Berichte per #tag) — sie erscheinen in zukünftigen Versionen dieses Leitfadens.