Zum Hauptinhalt springen
Kostenloses 20-minütiges Marketing-Audit
Begrenzte Plätze

Haben Sie eine Frage?

Wir antworten in der Regel innerhalb von 5 Minuten.

WWhatsApp TTelegram

ERP und Zahlungssysteme in Usbekistan: Payme, Click, Uzum Bank anbinden und automatisch abgleichen

Payme, Click, Uzum Bank ans ERP anbinden: Zahlungsphasen, Auftragsstatus, doppelte Anfragen, Fiskalbelege, Erstattungen und Checkliste für den Tagesabgleich.

ERP und Zahlungssysteme in Usbekistan: Payme, Click, Uzum Bank anbinden und automatisch abgleichen

Kurze Antwort: Eine ERP-Anbindung an ein Zahlungssystem bedeutet: Zahlt ein Kunde über Payme, Click oder Uzum Bank, wechselt der Auftrag im ERP selbstständig auf „bezahlt“. Niemand meldet sich im Portal an, um die Zahlung zu suchen. Am Tagesende gleicht das System drei Dinge selbst ab: Zahlungen, Aufträge und das Geld, das auf dem Bankkonto eingegangen ist. Abweichungen erscheinen als Liste.

Für ein ausländisches Unternehmen, das in Usbekistan startet, ist das früh relevant. Kunden zahlen dort mit Uzcard- und Humo-Karten, sehr häufig über diese Zahlungs-Apps und QR-Codes. Die Zahlungsanbindung ist einer der schnellsten Hebel bei der Automatisierung von Geschäftsprozessen: Die Regel ist klar, sie wiederholt sich täglich, und Fehler sind teuer — ein bezahlter Auftrag bleibt liegen oder ein unbezahlter wird versendet.

Ohne Anbindung: wo Geld verloren geht

Ein typisches Bild. Ein Kunde bestellt über Telegram und erhält einen Zahlungslink. Er zahlt und schickt einen Screenshot. Ein Mitarbeiter öffnet das Portal des Anbieters, sucht den Betrag und markiert den Auftrag manuell. Abends exportiert die Buchhaltung die Liste und gleicht sie in Excel mit den Aufträgen ab.

Bei wenigen Aufträgen ist das tragbar. Mit wachsendem Volumen entstehen Probleme:

  • Gleiche Beträge. Bei Dutzenden Zahlungen über 150.000 UZS pro Tag ist schwer erkennbar, welche Zahlung zu welchem Auftrag gehört.
  • Gefälschte oder alte Screenshots. Ein Auftrag wird auf Basis eines Bildes versendet, das Geld ist aber nie eingegangen.
  • Verzögerung. Die Zahlung kam nachts, der Mitarbeiter sieht sie morgens. Der Kunde wartet.
  • Abweichung zur Bank. Der Anbieter überweist eine Sammelsumme abzüglich seiner Gebühr. Sie wieder auf Aufträge aufzuteilen, ist eigene Arbeit.

Die Anbindung löst alle vier Punkte mit einer Regel: Nur die Bestätigung des Zahlungsanbieters schließt einen Auftrag ab.

Ablauf einer Zahlung: drei Phasen

Payme, Click und Uzum Bank nutzen unterschiedliche technische Protokolle. Die Logik ist gleich: Der Anbieter fragt Ihren Server nach dem Auftrag, belastet das Geld und meldet das Ergebnis.

Lesen Sie auch Der Kunde ruft zum zweiten Mal an und muss seinen Namen wieder buchstabieren: IP-Telefonie und ERP in Usbekistan verbinden Technology · 10 Min.
  • Prüfung — Payme Business (Merchant API): CheckPerformTransaction; Click (SHOP API): Prepare (action = 0); Was das ERP tut: Gibt es den Auftrag, stimmt der Betrag, ist er noch offen
  • Reservierung — Payme Business (Merchant API): CreateTransaction; Click (SHOP API): Antwort auf Prepare; Was das ERP tut: Auftrag auf „wartet auf Zahlung“, Ware reserviert
  • Bestätigung — Payme Business (Merchant API): PerformTransaction; Click (SHOP API): Complete (action = 1, error = 0); Was das ERP tut: Auftrag „bezahlt“, Versandaufgabe wird erzeugt
  • Storno — Payme Business (Merchant API): CancelTransaction; Click (SHOP API): Complete, error ≤ −1; Was das ERP tut: Reservierung aufgehoben, Status zurückgesetzt
  • Statusabfrage — Payme Business (Merchant API): CheckTransaction, GetStatement; Click (SHOP API): —; Was das ERP tut: Status auf beiden Seiten wird verglichen

Auch Uzum Bank betreibt ein Entwicklerportal und eine Merchant-API, die über Webhooks benachrichtigt. Fordern Sie die aktuelle Dokumentation und die Anschlussbedingungen beim Vertragsabschluss von der Bank an.

Einige wichtige Details aus der Dokumentation:

  • Die Payme Merchant API nutzt JSON-RPC 2.0. Beträge werden in Tiyin übergeben: 150.000 UZS entsprechen 15.000.000 Tiyin.
  • Payme storniert eine nicht bestätigte Transaktion 12 Stunden nach ihrer Erstellung mit dem Grund „Timeout“. In dieser Zeit darf das ERP keine Änderung des Auftragsinhalts zulassen.
  • Jede Click-Anfrage trägt eine MD5-Signatur, die mit einem geheimen Schlüssel berechnet wird. Stimmt die Signatur nicht, wird die Anfrage abgelehnt.
  • Erhält Click keine Antwort, kann es die Anfrage erneut senden. Schutz vor Doppelzahlungen bietet die click_trans_id.
  • Laut Payme-Dokumentation braucht eine Kasse ein registriertes Unternehmen: Einzelunternehmer oder Gesellschaft (etwa OOO oder AG). Privatpersonen können sich nicht anbinden.
Im Packraum eines Onlineshops scannt eine Mitarbeiterin eine bezahlte Bestellung vor dem Versand

Was im ERP richtig aufgebaut sein muss

Der Anbindungscode ist der kleinere Teil. Entscheidend sind die Regeln im ERP.

Auftragsstatus

Mindestens fünf Status sind nötig: neu, wartet auf Zahlung, bezahlt, storniert, erstattet. Jeder Übergang wird mit Person oder System protokolliert. „Bezahlt“ manuell setzen dürfen nur ein bis zwei Verantwortliche, und nur mit Pflichtkommentar.

Wiederholte Anfragen

Anbieter können dieselbe Nachricht zwei- oder dreimal senden. Netzstörungen oder langsame Antworten sind normal. Das ERP speichert die Transaktions-ID. Kommt eine Anfrage mit derselben ID erneut, wird der Auftrag nicht nochmals abgeschlossen, sondern die frühere Antwort zurückgegeben. Entwickler nennen das Idempotenz. Schreiben Sie diesen Begriff in Ihr Lastenheft.

Betrag und Währung

Prüfen Sie für jeden Anbieter einzeln, ob Beträge in Tiyin oder in Sum kommen. Bei Rabatten, Liefergebühren oder Promo-Codes muss der zu zahlende Betrag exakt der Endsumme des Auftrags entsprechen. Sonst lehnt der Anbieter die Zahlung zu Recht ab.

Wofür gezahlt wird

Im Einzelhandel hängt die Zahlung am Auftrag. Im B2B-Geschäft eher am Kundenkonto oder Vertrag, und der Kunde tilgt seinen Saldo in Teilen. Eine solche Zahlung muss den offenen Saldo mindern und Belege beginnend mit dem ältesten ausgleichen. Limits und Erinnerungen behandelt der Beitrag zum System zur Kontrolle von Forderungen. Verkaufen Sie über Telegram, kann ein Bot den Zahlungslink selbst senden, siehe ERP und Telegram-Bot.

Automatischer Abgleich: drei Ebenen

Auch bei funktionierender Anbindung ist ein täglicher Abgleich nötig. Fehler können im Code, im Netz oder beim Anbieter liegen. Der Abgleich läuft auf drei Ebenen.

1. Zahlung ↔ Auftrag. Die Liste der „bezahlten“ Aufträge im ERP wird mit dem Register des Anbieters verglichen. Payme bietet dafür die Methode GetStatement. Bei anderen Anbietern dienen ein Registerexport aus dem Portal oder eine eigene API.

2. Register ↔ Bankeingang. Anbieter überweisen meist eine Summe abzüglich ihrer Gebühr. Die Prüfformel:

Erwarteter Eingang = Zahlungen im Zeitraum − Erstattungen − Gebühr laut Vertrag

3. Bank ↔ Buchhaltung. Der Kontoauszug zeigt, welche Zahlungen welches Zeitraums jeder Eingang im ERP ausgleicht. Dann stimmen Kassenbericht und Kontostand überein.

Beispiel mit angenommenen Werten. Ein Onlineshop in Fergana erhält an einem Tag 80 Zahlungen über insgesamt 12.000.000 UZS. Eine Zahlung über 300.000 UZS wurde erstattet. Als vertragliche Gebühr nehmen wir rein zur Illustration 1 % an. Erwarteter Eingang: (12.000.000 − 300.000) × 0,99 = 11.583.000 UZS. Gehen 11.433.000 UZS bei der Bank ein, erscheint die Differenz von 150.000 UZS auf der Liste. Prüfen Sie zuerst drei Dinge: eine im ERP abgeschlossene, beim Anbieter aber stornierte Zahlung, eine vom Vertrag abweichende Gebühr oder Zahlungen, die erst mit der Überweisung des Folgetags kommen. Die tatsächliche Gebühr und die Behandlung von Erstattungen entnehmen Sie Ihrem Vertrag.

Auch der Zeitpunkt zählt. Kommen die Tageseinnahmen später auf dem Konto an, beeinflusst das Ihre Auszahlungsplanung. Führen Sie sie als eigene Zeile im Zahlungskalender.

Fiskalbelege und Dokumente

In Usbekistan ist Geld, das über Zahlungssysteme eingeht, nicht von den Fiskalpflichten ausgenommen. Als am 1. November 2022 das genehmigte Zusammenspiel von Online-Kassen, Zahlungsdiensten und dem Betreiber der Fiskaldaten in Kraft trat, schalteten einige Zahlungsdienste QR-Zahlungen und weitere Funktionen vorübergehend ab. Der Einsatz von Online-Kassen und virtuellen Kassen ist im Ministerkabinettsbeschluss Nr. 943 vom 23. November 2019 geregelt. Dessen Anlage 1a betrifft Fiskalbelege über Zahlungsorganisationen und Marktplätze. Der Verkäufer kann den Beleg aber jederzeit auch über seine eigene Online-Kasse oder virtuelle Kasse ausstellen.

Praktische Folgerung für das ERP:

  • Bei jeder Zahlung muss der Status des Fiskalbelegs sichtbar sein: ausgestellt, ausstehend, Fehler.
  • Erzeugt der Anbieter den Beleg, sollten seine Daten ins ERP zurückfließen. Payme bietet dafür die optionale Methode SetFiscalData: Sie liefert Beleg-ID, Fiskalzeichen und QR-Code-Link. Zahlung und Storno kommen als getrennte Belege.
  • Stellen Sie den Beleg selbst aus, übergibt das ERP der Kasse die Auftragspositionen mit IKPU-(MXIK-)Produktcodes.

B2B-Kunden benötigen zusätzlich eine elektronische Rechnung. Wie sie automatisch aus dem Verkaufsbeleg versendet wird, steht im Beitrag zur ERP-Anbindung an die E-Rechnung (ESF).

In einer Apotheke druckt der Drucker neben dem Kartenterminal einen Beleg, während Medikamente übergeben werden

Erstattungen und Stornierungen

Erstattungen sind der am häufigsten vergessene Teil. Legen Sie drei Regeln fest:

  1. Wann Storno, wann Erstattung. Ware nicht versendet — Storno. Versendet und zurückgekommen — Erstattung. Bei Payme zeigt der Transaktionsstatus, ob die Zahlung bestätigt war: −1 bedeutet Storno vor der Bestätigung, −2 Storno einer bestätigten Zahlung. Im ERP sollten Storno und Erstattung getrennte Belege sein.
  2. Wer freigibt. Eine Erstattung darf kein einzelner Knopf beim Sachbearbeiter sein. Ab einer Betragsgrenze gibt die Leitung frei.
  3. Lager und Beleg. Bei der Erstattung wird die Ware wieder eingebucht und ein Rückgabebeleg erstellt. Alle drei Schritte hängen an einem Dokument.

Einführungsphasen und Checkliste

  • 1. Vorbereitung — Was passiert: Vertrag mit dem Anbieter, Kassen- oder Service-ID, geheime Schlüssel; Ergebnis: Zugang zur Testumgebung
  • 2. Regeln — Was passiert: Status, Erstattungsablauf, Fiskalmodell, Zuständigkeiten; Ergebnis: Einseitige Arbeitsanweisung
  • 3. Entwicklung — Was passiert: Anbindung, Signaturprüfung, wiederholte Anfragen, Protokoll; Ergebnis: Getestete Verbindung
  • 4. Tests — Was passiert: Erfolg, Storno, Timeout, falscher Betrag, Duplikat; Ergebnis: Ergebnisse der Testszenarien
  • 5. Parallelbetrieb — Was passiert: 1–2 Wochen manueller und automatischer Abgleich nebeneinander; Ergebnis: Ursachen der Abweichungen geklärt
  • 6. Kontrolle — Was passiert: Täglicher Abgleichsbericht, Warnungen; Ergebnis: Abweichungen kommen nur als Liste

Prüfen Sie vor dem Start:

  • ☐ Geheime Schlüssel liegen in geschützten Einstellungen, nicht im Code.
  • ☐ Anfragen mit ungültiger Signatur oder Autorisierung werden abgelehnt.
  • ☐ Eine Transaktions-ID schließt einen Auftrag nur einmal ab.
  • ☐ Jede Anfrage und Antwort wird protokolliert.
  • ☐ Timeout und Storno heben die Warenreservierung auf.
  • ☐ Der tägliche Abgleichsbericht geht automatisch an Leitung oder Buchhaltung.

Typische Fehler

  • Screenshots vertrauen. Nur die Bestätigung des Anbieters schließt einen Auftrag ab.
  • Ein gemeinsamer Schlüssel. Test- und Produktivschlüssel werden verwechselt.
  • Kein Protokoll. Im Streitfall lässt sich nicht belegen, was ankam und was geantwortet wurde.
  • Gebühr nicht berücksichtigt. Der Bankeingang ist immer „zu niedrig“, und niemand geht dem nach.
  • Manuelle Erstattung. Das Geld ist zurück, Lager und Beleg sind unverändert.

Fazit

Die Zahlungsanbindung beruht auf drei Elementen: einer korrekten Verbindung zum Anbieter, klaren Status im ERP und einem täglichen Abgleich auf drei Ebenen. Beginnen Sie heute: Nehmen Sie das Zahlungsregister der letzten Woche und gleichen Sie es mit den Bankeingängen ab. Dauert die Erklärung der Differenzen länger als eine Stunde, ist es Zeit zu automatisieren.

Häufige Fragen

Brauchen Sie ein ERP, um Payme oder Click zu nutzen?

Nein. Ein kleiner Shop kommt mit einem fertigen Zahlungslink oder QR-Code aus dem Kundenportal des Anbieters aus. Die ERP-Anbindung wird nötig, wenn das Auftragsvolumen wächst: Das manuelle Suchen von Zahlungen kostet Stunden, bezahlte Aufträge gehen verspätet raus oder die Kasse stimmt nicht mit dem Bankeingang überein.

Was passiert, wenn ein Kunde doppelt bezahlt?

Bei einer sauber gebauten Anbindung wird der Auftrag nur einmal abgeschlossen. Das ERP speichert die Transaktions-ID des Anbieters und beantwortet eine wiederholte Anfrage mit derselben ID mit der früheren Antwort. Hat der Kunde tatsächlich zweimal getrennt bezahlt, erscheint die zweite Zahlung als Überzahlung, und eine verantwortliche Person entscheidet über Erstattung oder Verrechnung als Anzahlung.

Wer stellt den Fiskalbeleg aus: der Zahlungsanbieter oder der Verkäufer?

Das hängt von Ihrem Abrechnungsmodell und dem Vertrag mit dem Anbieter ab. Teils erzeugt die Zahlungsorganisation den Beleg, teils stellt ihn der Verkäufer über seine eigene Online-Kasse oder virtuelle Kasse aus. Klären Sie das Modell vor der Anbindung mit Ihrer lokalen Buchhaltung und machen Sie den Belegstatus jeder Zahlung im ERP sichtbar.

Lässt sich die Anbindung vor dem Start testen?

Ja. Die Zahlungsanbieter stellen Entwicklerdokumentation und eine Testumgebung bereit. Testen Sie vor dem Start eine erfolgreiche Zahlung, eine Stornierung, eine wiederholte Anfrage, einen falschen Betrag und einen nicht existierenden Auftrag.

Werden Zahlungen noch von Hand abgeglichen?

Wir sehen uns an, wie Ihre Zahlungsarten, Aufträge und Bankeingänge heute zusammenhängen, und zeigen, welchen Zahlungsfluss Sie zuerst automatisieren sollten.

Zahlungsanbindung besprechen →

Lassen Sie uns herausfinden, wo wir starten

Kostenlose Beratung mit einem DORA-Spezialisten

In Telegram schreiben

Lassen Sie uns Ihr Projekt besprechen

Hinterlassen Sie Ihre Nummer, ein Spezialist meldet sich bei Ihnen.

Send a request via Telegram

Ihre Daten werden nur zur Kontaktaufnahme verwendet.