Statussynchronisierung · Monobank
Monobank – die Zahlung erscheint von selbst in der Bestellung
BetaBeta: Die Verbindung ist bereits heute möglich; die Funktionen des Kanals werden noch ausgebaut.
Der Käufer bezahlt eine Rechnung, das CRM erhält von Monobank eine signierte Bestätigung, ordnet die Zahlung der Bestellung zu und informiert Ihr Team sofort. Kein manueller Abgleich von Kontoauszügen.
Webhook log
webhook received · order #SHOP-10245
x-sign
OK
synced automatically
Status → Confirmed
So funktioniert es
Signierter Webhook
Monobank sendet den Rechnungsstatus mit einem x-sign-Header. Das CRM liest den rohen Request-Body und prüft die ECDSA-Signatur mit dem öffentlichen Schlüssel Ihres Händlerkontos – andernfalls akzeptiert es nichts.
Zahlung an der Bestellung
Es wird ein Zahlungseintrag mit Betrag, Währung, Methode und Status erstellt und über die Rechnungsreferenz mit der Bestellung verknüpft.
Bestellstatus
Die Bestellung wechselt auf „Bestätigt“, wenn sie noch „Ausstehend“ ist und die Zahlungen die Bestellsumme decken.
Ihr Team wird informiert
Eine erfolgreiche Zahlung löst genau eine Glockenbenachrichtigung und einen Push für Inhaber und Manager aus – auch dann, wenn die Bank sie erneut zugestellt hat.
Zahlungsjournal
Jede Zahlung jedes Anbieters in einer Liste mit Suche, Filtern und Verknüpfungsstatus. Sie sehen, wofür bezahlt wurde, auch wenn noch keine Bestellung existiert.
Teilzahlung ist sichtbar
Die Rechnung zeigt einen abgeleiteten Status – unbezahlt, teilweise bezahlt oder bezahlt – auf Grundlage der tatsächlichen Zahlungen in der Währung der Bestellung.
Wo die Verantwortung endet
- Das CRM nimmt entgegen
- signierte Webhooks zum Rechnungsstatus; den Status „abgelaufen“ sendet Monobank nicht per Webhook, daher verfolgt dies, wer die Rechnung erstellt hat
- Das CRM erfasst
- Rechnungs-ID, Status, den tatsächlichen Betrag und die Währung; die Rechnungsreferenz → die externalId der Bestellung
- Das CRM kann ändern
- „Ausstehend“ → „Bestätigt“, und nur bei einer erfolgreichen Zahlung, die die Bestellung in der richtigen Währung deckt
- Das CRM erstellt
- eine Rechnung, wenn ein Manager an einer Bestellung oder Rechnung auf „Zahlungslink“ klickt – Monobank hostet die Zahlungsseite, und der Link bleibt einen Tag lang zahlbar
- Das CRM macht nie
- Rechnungen stornieren, Rückerstattungen, geteilte Zahlungen, eine Karte belasten oder Kartendaten speichern
- Währungen
- Hrywnja sowie Dollar und Euro – die Währung stammt aus dem numerischen ISO-4217-Code im Webhook, und die Beträge werden aus der kleinsten Einheit umgerechnet
Eine Zahlung, die keine Bestellung gefunden hat, geht nicht verloren
- Stimmt die Rechnungsreferenz mit keiner Bestellung überein, wird die Zahlung trotzdem gespeichert – unter Commerce → Zahlungen, als nicht verknüpft markiert.
- Ein Manager öffnet sie und verknüpft sie entweder mit einer vorhandenen Bestellung oder erstellt daraus eine neue Bestellung, wobei Käufer und Betrag bereits bekannt sind.
- Der umgekehrte Weg funktioniert auch aus der Bestellung: Wählen Sie aus der Liste eine vorhandene, nicht verknüpfte Zahlung aus.
- Eine Zahlung kann von Hand erfasst werden – für Barzahlungen oder eine Banküberweisung, die nie über das Acquiring lief.
- Ein erneut zugestellter Webhook erzeugt kein Duplikat: Der Eintrag ist über die Rechnungs-ID idempotent.
Die Kontoprüfung ist eine Diagnose, keine Hürde
Der Callback funktioniert, sobald das Händler-Token gespeichert ist: Ein korrekt signiertes Ereignis von Monobank authentifiziert sich selbst, sodass die Forderung „erst einen Test bestehen“ ein künstliches Hindernis zwischen Ihnen und einer echten Zahlung wäre. Wenn Sie möchten, führt der Verbindungstest einen sicheren Lesezugriff aus und zeigt, zu welchem Konto das Token gehört, ohne im CRM etwas zu ändern.
Einrichtung
- 01
Monobank-Adapter hinzufügen
Fügen Sie das Händler-Token aus Ihrem Monobank-Acquiring-Konto ein. Die Webhook-Adresse erscheint auf der Seite des erstellten Adapters. Das Token wird verschlüsselt gespeichert.
- 02
Adresse in webHookUrl übergeben
Ihr Shop fügt diese Adresse bei jeder Anfrage zum Erstellen einer Rechnung in das Feld webHookUrl ein – die offizielle API beschreibt keinen globalen Händler-Webhook. Tragen Sie die externalId der CRM-Bestellung in merchantPaymInfo.reference ein: So findet die Zahlung ihre Bestellung.
- 03
Mit einer echten Zahlung prüfen
Führen Sie eine echte Zahlung durch. Sie sollte im Journal und in der Bestellung erscheinen, und Ihr Team sollte die Benachrichtigung erhalten.
Häufige Fragen
- Wie verbinde ich Monobank mit dem CRM?
- Fügen Sie unter Einstellungen → Integrationen den Monobank-Adapter hinzu, fügen Sie das Händler-Token aus Ihrem Acquiring-Konto ein und kopieren Sie die Webhook-Adresse. Ihr Shop übergibt diese Adresse dann beim Erstellen einer Rechnung im Feld webHookUrl – und Zahlungen erscheinen im CRM.
- Brauche ich einen separaten Test, bevor ich echte Zahlungen annehme?
- Nein. Ein signiertes Ereignis von Monobank authentifiziert sich selbst, daher werden Webhooks akzeptiert, sobald das Token gespeichert ist. Der Verbindungstest steht als Diagnose zur Verfügung, ist aber keine Voraussetzung.
- Speichert das CRM Kartendaten?
- Nein. Kartennummer und CVV erreichen das CRM nie und werden nie gespeichert. Gespeichert werden nur Betrag, Währung, Status und Rechnungs-ID – genug, um die Zahlung mit der Bestellung abzugleichen.
- Wie findet das CRM die richtige Bestellung?
- Über das Feld für die Rechnungsreferenz: Ihr Shop trägt dort die externalId der Bestellung ein, und das CRM sucht in Ihrem Arbeitsbereich nach einer Bestellung mit genau dieser Kennung. Ein Webhook kann die Bestellungen eines anderen Arbeitsbereichs nicht erreichen.
- Was geschieht, wenn die Referenz nicht übereinstimmt?
- Die Zahlung wird nicht verworfen. Sie wird im Zahlungsjournal als nicht verknüpft gespeichert, und ein Manager verknüpft sie mit einer vorhandenen Bestellung oder erstellt daraus eine neue.
- Erstellt das CRM Rechnungen oder führt es Rückerstattungen aus?
- Eine Rechnung ja – wenn Sie darum bitten: Die Schaltfläche „Zahlungslink“ an einer Bestellung oder Rechnung erstellt eine Monobank-Rechnung und gibt einen Link zurück, den der Manager dem Käufer sendet. Rückerstattungen, Rechnungsstornierungen und alle Abbuchungen bleiben bei Monobank und Ihrem Shop; das CRM führt nichts davon aus.
- Lassen sich andere Anbieter auf dieselbe Weise annehmen?
- Ja. LiqPay, WayForPay und Hutko werden auf dieselbe Weise verbunden und schreiben in dasselbe Zahlungsjournal – jeder mit seinem eigenen Signaturverfahren, genau so, wie es die offizielle Dokumentation des jeweiligen Anbieters verlangt.
Mehr erfahren
Häufig gemeinsam verbunden
LiqPay
BetaEine auf Seiten von LiqPay bestätigte Zahlung löst eine Teambenachrichtigung aus und aktualisiert eine passende Bestellung im CRM.
Mehr erfahrenWayForPay
VerfügbarDas CRM prüft jedes Zahlungsergebnis, benachrichtigt Ihr Team und verknüpft die Zahlung mit einer bestehenden Bestellung. Ohne Treffer bleibt sie in einer übersichtlichen Abgleichwarteschlange.
Mehr erfahrenHutko
VerfügbarNach jeder Zahlung erfasst das CRM das Ergebnis, benachrichtigt Ihr Team und ordnet die Zahlung entweder einer vorhandenen Bestellung zu oder hält sie in einer übersichtlichen Abgleichswarteschlange bereit.
Mehr erfahrenRozetka
BetaDer größte Marktplatz der Ukraine: Bestellungen kommen von selbst ins CRM, Status und Bestand gehen zurück ins Verkäuferkonto, und Käuferfragen werden zu Leads mit einem Verantwortlichen und einem nächsten Schritt.
Mehr erfahrenProm.ua
VerfügbarBestellungen, Zahlungen und Lieferung kommen von selbst an. Käuferfragen werden zu Leads, die Sie direkt im CRM beantworten, ohne das Prom-Konto zu öffnen.
Mehr erfahren
Beta: Beta: Die Verbindung ist bereits heute möglich; die Funktionen des Kanals werden noch ausgebaut.
Monobank verbinden
Acquiring-Zahlungen landen von selbst in ihren Bestellungen – und diejenigen, die keine Bestellung finden, warten im Journal, statt zu verschwinden.