Auf Mollie installieren

Mollie ist ein Zahlungsdienstleister für Unternehmen im EWR, in der Schweiz und in Großbritannien, und Rekomi ist direkt damit integriert. Für die Einrichtung fügst du nur einmal etwas ein: Du gibst Rekomi ein Advanced Access Token mit sieben Berechtigungen (sechs Leseberechtigungen plus webhooks.write), und Rekomi prüft es live, legt einen signierten Webhook in deiner Mollie-Organisation an und speichert das Signing Secret des Webhooks für dich. Du musst nichts zurück in Mollie kopieren und kein Webhook-Formular ausfüllen. Ab dann landen Zahlungen, Abo-Verlängerungen, Erstattungen und Rückbuchungen in Rekomi, ohne dass du Relay-Code schreiben oder pflegen musst. Du bist noch am Abwägen? Lies Warum Rekomi für Mollie →.

Eine Sache vorab: Die Zugangsdaten sind ein Advanced Access Token, kein normaler API-Schlüssel. Ein normaler API-Schlüssel (live_... oder test_...) kann Zahlungen und Erstattungen anlegen, aber keine Webhooks verwalten, deshalb lehnt Rekomi ihn mit einer Fehlermeldung ab, die genau das sagt. Das Advanced Access Token hat nur Leseberechtigungen plus die Verwaltung von Webhooks, sodass Rekomi nie Zugangsdaten hält, mit denen sich dein Geld bewegen lässt. Nach dem Verbinden dient das Token dazu, den Webhook zu verwalten, regelmäßig einen Gesundheitscheck auszuführen und alle 30 Minuten nach neuen Zahlungen, Erstattungen und Rückbuchungen zu sehen. Deine Verkäufe kommen zuerst über den signierten Webhook an, die Prüfung alle 30 Minuten ist die Absicherung.

Was du brauchst

• Eine Mollie-Organisation im Live-Modus. Der Testmodus von Mollie kennt nur EUR und ist vollständig vom Live-Modus getrennt. Die Produktivverbindung von Rekomi arbeitet nur im Live-Modus; der Testmodus steht in einer Staging-Umgebung zur Verfügung.
• Ein Advanced Access Token mit sieben Berechtigungen. Öffne im Mollie-Dashboard Developers > API keys und erstelle ein Advanced Access Token (nenne es „Rekomi“) mit diesen angehakten Berechtigungen: webhooks.read, webhooks.write, payments.read, refunds.read, profiles.read, organizations.read und customers.read. Mit customers.read kann Rekomi die E-Mail-Adresse des Käufers aus dem Mollie-Kunden lesen, zu dem eine Zahlung gehört, wenn die Zahlung selbst keine enthält, sodass ein auf deiner Website erfasster Lead trotzdem passen kann. Ein Token, das erstellt wurde, bevor customers.read auf diese Liste kam, hat diese Berechtigung nicht. Hast du Mollie also früher verbunden, erstelle ein neues Advanced Access Token mit allen sieben Berechtigungen und verbinde unter /dashboard/setup/mollie neu (deine Historie bleibt erhalten); bis dahin übergib billingAddress.email bei den Zahlungen, die du selbst anlegst. Nur ein Nutzer mit der Rolle Admin kann ein solches Token erstellen. Erstelle das Token für alle Website-Profile deiner Organisation und für den Live-Modus. Mollie dokumentiert das nicht, aber ein Token, das auf ein einzelnes Website-Profil beschränkt ist, wird bei den Aufrufen, die Rekomi zum Verbinden macht, mit 403 beantwortet, und das Verbinden scheitert. Rekomi verfolgt trotzdem ein Website-Profil pro Workspace; sieht das Token mehrere, fragt Rekomi nach dem Einfügen, welches verknüpft werden soll.
• Zwei Minuten. Kein OAuth-Hin-und-her, kein Webhook-Formular und kein Secret zum Kopieren: Im ganzen Ablauf fügst du nur einmal etwas ein.

In Rekomi verbinden

Schritt 1. Öffne /dashboard/setup/mollie.

Schritt 2. Füge dein Advanced Access Token ein und klicke auf Mollie verbinden. Rekomi prüft das Token live bei Mollie (es liest deine Organisation, deine Website-Profile und deine vorhandenen Webhooks), bittet dich, ein Website-Profil zu wählen, falls das Token mehr als eines sieht, und legt dann einen Webhook an, der auf die URL deines Workspaces zeigt und die benötigten Ereignisse abonniert. Der Webhook heißt „Rekomi“, gefolgt von einer kurzen ID für deinen Workspace, weil Mollie eindeutige Webhook-Namen innerhalb einer Organisation verlangt und sich zwei Workspaces eine Organisation teilen können. Mollie gibt das Signing Secret des Webhooks einmal zurück, in der Antwort auf das Anlegen, und Rekomi speichert es verschlüsselt. Lässt sich der Webhook nicht anlegen, wird nichts gespeichert, und die Fehlermeldung sagt, warum.

Das war's. Die Einrichtungsseite zeigt die Webhook-URL und die gewährten Ereignisse nur zur Information; Rekomi verwaltet den Webhook komplett selbst.

Attribution: rekomi_ref in den Metadaten übergeben (Pflicht)

Mollie hostet seinen Checkout auf der eigenen Domain und führt dort keine Skripte aus, deshalb muss die Affiliate-Empfehlung vom Browser des Besuchers in den Zahlungsdatensatz gelangen. Dieser Schritt ist für die Attribution von Neukunden Pflicht, es sei denn, du nutzt den unten beschriebenen Abgleich über die Lead-E-Mail: Ohne einen der beiden Wege kommen Verkäufe ohne Empfehlung an, und es wird keine Provision gutgeschrieben.

Sorge zuerst dafür, dass das Rekomi-Tracking-Skript auf deiner eigenen Website installiert ist, damit der Affiliate-Klick erfasst wird und window.Rekomi.getReferral() einen Wert liefert, wenn ein Besucher über einen Affiliate-Link kommt. Das ist dasselbe Skript, das jede Rekomi-Installation nutzt; die Anleitung für deine Website-Plattform im Installations-Hub deckt es ab. Ein eigenes Skript für Mollie brauchst du nicht: Die native Verbindung, die du oben eingerichtet hast, erfasst den Verkauf. Setze die Empfehlung dann dort, wo du die Zahlung oder das Abonnement anlegst:

Einmalzahlungen. Lies die Empfehlung im Frontend mit window.Rekomi.getReferral() aus, schicke sie mit der Checkout-Anfrage an dein Backend und setze sie in metadata bei POST /v2/payments:

{
  "amount": { "currency": "EUR", "value": "49.00" },
  "description": "Pro plan",
  "redirectUrl": "https://example.com/thanks",
  "metadata": { "rekomi_ref": "REFERRAL_FROM_YOUR_FRONTEND" }
}

Abonnements. Setze denselben Schlüssel in metadata bei POST /v2/customers/{customerId}/subscriptions. Mollie gibt die Abo-Metadaten an jede Zahlung weiter, die das Abonnement erzeugt, sodass jede Verlängerung schon mit dem Eintrag ankommt:

{
  "amount": { "currency": "EUR", "value": "49.00" },
  "interval": "1 month",
  "description": "Pro plan",
  "metadata": { "rekomi_ref": "REFERRAL_FROM_YOUR_FRONTEND" }
}

Setze den Eintrag auch bei der ersten Zahlung (der mit sequenceType: "first", die das Mandat einrichtet), weil Mollie sie getrennt vom Abonnement anlegt.

Gutscheincodes. Mollie hat kein eigenes Objekt für Gutscheine oder Rabattcodes. Akzeptiert dein Checkout einen Code pro Affiliate, übergib ihn also im selben Aufruf als metadata.rekomi_coupon. Ein Gutschein-Eintrag hat Vorrang vor dem Empfehlungs-Eintrag, wenn beide vorhanden sind. Rekomi liest den Gutschein nur bei Einmalzahlungen und ersten Zahlungen; Verlängerungen werden über die Kunden- und Abo-Historie demselben Affiliate gutgeschrieben, ein abweichender Provisionssatz eines Gutscheins gilt also für die erste Zahlung, nicht für jeden Zyklus.

SaaS mit Anmeldung zuerst (der Abgleich über die Lead-E-Mail). Meldet sich dein Kunde zuerst an und wird die erste Zahlung Tage später aus deinem Backend angelegt (zum Beispiel bei einer Testphase ohne Karte), gibt es zum Zeitpunkt der Zahlung womöglich keinen Browser, aus dem sich die Empfehlung lesen ließe. Erfasse in diesem Fall den Lead in deinem Anmeldeformular mit der E-Mail-Erfassung des Tracking-Skripts (data-rkmi-email-capture="auto" am Loader-Tag oder Rekomi.convert(); siehe Lead-Tracking) und übergib die E-Mail-Adresse des Käufers beim Anlegen der Zahlung als billingAddress.email. Rekomi gleicht die Zahlung dann mit einem Lead aus den letzten 90 Tagen ab. Eine Mollie-Zahlung enthält nur dann eine E-Mail-Adresse, wenn du eine mitschickst (Zahlungen per Karte und iDEAL enthalten standardmäßig keine). Enthält die Zahlung keine, gehört aber zu einem Mollie-Kunden, wie es bei jeder Abo-Zahlung der Fall ist, liest Rekomi die E-Mail-Adresse stattdessen aus diesem Kundendatensatz (dafür ist customers.read da). Mit E-Mail-Erfassung in deinem Anmeldeformular werden Abo-Verkäufe also auch ohne Metadaten-Eintrag zugeordnet. Der Eintrag bleibt der genaue Weg, behalte ihn also überall bei, wo dein Backend ihn setzen kann. Ein Token, das erstellt wurde, bevor customers.read auf die Liste kam, hat diese Berechtigung nicht. Hast du Mollie also früher verbunden, erstelle ein neues Advanced Access Token mit allen sieben Berechtigungen und verbinde unter /dashboard/setup/mollie neu (deine Historie bleibt erhalten); bis dahin übergib billingAddress.email bei den Zahlungen, die du selbst anlegst, und Verlängerungen folgen über die Kundenhistorie der ersten Zahlung. Eine Einmalzahlung, die ohne Kunden angelegt wird, braucht weiterhin billingAddress.email. Ein Affiliate, der mit seiner eigenen E-Mail-Adresse kauft, bekommt über diesen Abgleich nie eine Gutschrift.

Verlängerungen ohne Eintrag greifen auf die Attributionshistorie des Kunden und des Abonnements zurück, sodass ein einmal zugeordneter Kunde weiter demselben Affiliate gutgeschrieben wird. Der Wert rekomi_ref wird ohne Rücksicht auf Groß- und Kleinschreibung mit dem Slug des Affiliates abgeglichen. Ein Code, den du als SERKAN speicherst, wird also dem Affiliate mit dem Slug serkan gutgeschrieben.

So werden Verkäufe und Verlängerungen erfasst

• payment.paid ist das Geldereignis. Einmalzahlungen, die erste Abo-Zahlung und jede Verlängerung werden über das Ereignis payment.paid von Mollie erfasst, einmal pro Zahlungs-ID, mit dem Betrag, den der Kunde gezahlt hat (oder mit dem eingezogenen Betrag, wann immer Mollie einen meldet). Eine Zahlung, die nur autorisiert, ausstehend, fehlgeschlagen, abgebrochen oder abgelaufen ist, erzeugt nie eine Conversion.
• Ob Erstzahlung oder Verlängerung, steht in der Zahlung selbst. Mollie kennzeichnet jede Zahlung mit einem sequenceType (oneoff, first oder recurring), deshalb muss Rekomi nie raten, welche Zahlung die Verlängerung ist. Wiederkehrende Provisionsregeln (Verzögerungen, Obergrenzen, Kündigungsfenster) richten sich nach dieser Kennzeichnung.
• Verlängerungen tragen die weitergegebenen Abo-Metadaten. Mollie kopiert die Metadaten des Abonnements in jede Zahlung, die es erzeugt, sodass eine Verlängerung mit demselben rekomi_ref ankommt, das du einmal gesetzt hast. Eine Verlängerung ohne Eintrag greift auf die Attributionshistorie zurück. Mollie sendet keine Ereignisse zum Lebenszyklus von Abonnements (es gibt keinen Webhook für „Abonnement gekündigt“), deshalb wird eine Kündigung daraus abgeleitet, dass ein Abonnement keine bezahlten Zahlungen mehr erzeugt.
• Wiederholte Versuche nach einer fehlgeschlagenen Verlängerung kosten nichts. Mollie wiederholt eine fehlgeschlagene Abo-Zahlung bis zu fünfmal, einmal pro Tag, jedes Mal als neue Zahlung; erfasst wird nur die, die mit paid endet.
• Eine erste Zahlung unter einer Einheit ihrer Währung ist nie ein Verkauf. Die Zahlung zur Mandatsprüfung von Mollie (0.00 oder 0.01 EUR, die Zahlung mit sequenceType: "first", die nur das Mandat einrichtet) wird übersprungen und startet nie das Zeitfenster für wiederkehrende Provisionen. Das tut erst die erste echte Zahlung ab einer Einheit (1.00 EUR, 1 JPY), und sie ist der Verkauf. Jede andere bezahlte Zahlung wird erfasst.
• Zahlungen vor dem Verbinden werden nie nachträglich importiert. Rekomi beginnt mit dem Moment des Verbindens; eine Erstattung einer früheren Zahlung wird quittiert und protokolliert, und es gibt nichts zurückzuholen.
• Alles wird anhand der zugrunde liegenden IDs von Zahlung, Erstattung und Rückbuchung dedupliziert, sodass die Neuzustellungen von Mollie (bis zu zehn Versuche über 26 Stunden) und die Prüfung alle 30 Minuten nie doppelt zählen.

Erstattungen und Rückbuchungen

Erstattungen machen die Provision automatisch rückgängig: Jede Erstattung holt ihren eigenen Betrag zurück, sobald sie bei Mollie den Status refunded erreicht (der Moment, in dem das Geld wirklich an den Kunden zurückgeht). Eine Teilerstattung holt also den erstatteten Anteil zurück, und mehrere Teilerstattungen holen so lange zurück, bis die ursprüngliche Provision aufgebraucht ist, nie darüber hinaus. Eine Erstattung, die noch in der Warteschlange, ausstehend oder in Bearbeitung ist, ändert noch nichts; eine, die fehlschlägt oder abgebrochen wird, holt nie etwas zurück.

Rückbuchungen holen den zurückgebuchten Betrag zurück, sobald Mollie die Rückbuchung erhält. Wird die Rückbuchung später rückgängig gemacht, wird die Provision in dieser Version nicht automatisch wiederhergestellt; die Rücknahme wird protokolliert, damit du bei Bedarf manuell nachbessern kannst.

Bei manchen Mollie-Konten sind Ereignisse zu Erstattungen und Rückbuchungen noch in der Beta. Mollie stellt payment.paid jedem Konto zur Verfügung, bietet Ereignisse zu Erstattungen und Rückbuchungen aber als Beta an, die du beim Mollie-Support anfragst. Rekomi fordert sie beim Verbinden an und nutzt sie, wo sie gewährt werden. Wo nicht, geht nichts verloren: Rekomi prüft deine Erstattungen und Rückbuchungen (und Zahlungen) alle 30 Minuten und holt genauso zurück. Der einzige Unterschied sind bis zu 30 Minuten Verzögerung statt ein paar Sekunden. Dieselbe Prüfung deckt auch Zustellungen ab, die die Wiederholungsstaffel von Mollie nicht durchbekommen hat.

Währungen

Mollie nimmt Zahlungen in 28 Währungen an, und die Liste von Rekomi mit über 135 erlaubten Währungen deckt sie alle ab, einschließlich ISK und JPY ohne Nachkommastellen, die in der richtigen Einheit erfasst werden. Rekomi erfasst immer den Betrag, den der Kunde gezahlt hat, in der Währung, in der er gezahlt hat, nie die Abrechnungsumrechnung von Mollie. Der Testmodus von Mollie kennt nur EUR.

Basis der Provision

Mollie ist ein Zahlungsdienstleister, kein Merchant of Record. Eine Zahlung enthält also den Betrag, den der Kunde gezahlt hat, inklusive Mehrwertsteuer, und kein eigenes Steuerfeld. Schickst du bei der Zahlung Bestellpositionen mit Mehrwertsteuerbeträgen mit (lines[] mit vatAmount), berechnet Rekomi die Provision auf die Summe dieser Positionen vor Steuern, sodass deine Affiliates am Verkauf verdienen, nicht an der Mehrwertsteuer. Enthält eine Zahlung keine Positionen, wird die Provision auf den Zahlungsbetrag berechnet. Erstattungen und Rückbuchungen werden auf dieselbe Basis umgerechnet, und jede Rückforderung ist auf den gutgeschriebenen Betrag begrenzt.

Sicherheit

• Jede Webhook-Zustellung wird per Signatur geprüft, bevor irgendetwas verarbeitet wird: Mollie signiert den rohen Body mit dem Secret des Webhooks (HMAC-SHA256, gesendet im Header X-Mollie-Signature), und bei fehlender, fehlerhafter oder abweichender Signatur greift bei Rekomi Fail-closed. Den älteren, unsignierten Webhook-Stil von Mollie (ein Formular-Post, der nur eine Zahlungs-ID enthält) lehnt Rekomi ab; Rekomi legt immer nur die signierte Variante an.
• Das Access Token und das Webhook-Signing-Secret werden verschlüsselt gespeichert und nie von der API zurückgegeben. Das Signing Secret siehst und berührst du nie; Mollie gibt es einmal zurück, wenn Rekomi den Webhook anlegt, und Rekomi speichert es direkt.
• Das Token hat keine Berechtigung, Zahlungen oder Erstattungen anzulegen, Rekomi kann also kein Geld in deinem Mollie-Konto bewegen.
• Rekomi legt genau einen Webhook an, mit dem Namen „Rekomi“, gefolgt von einer kurzen ID für deinen Workspace. Jede Zahlung wird vor dem Erfassen mit dem verbundenen Website-Profil und dem Modus abgeglichen, und eine Erstattung oder Rückbuchung gilt immer nur für eine Zahlung, die dieser Workspace erfasst hat. Eine Testerstattung kann also nie eine Live-Provision berühren.
• Beim Trennen wird der Webhook bei Mollie gelöscht, und das gespeicherte Token und Secret werden entfernt.

Gut zu wissen

• Eine Conversion-Quelle pro Workspace. Mollie Connect schließt Stripe (über die Rekomi-App für Stripe), Paddle, Braintree, die Apps für Shopify, Wix und BigCommerce, das WooCommerce-Plugin, Lemon Squeezy, Chargebee, Polar, Recurly, Gumroad, Creem, Dodo Payments und die S2S-API aus, damit derselbe Verkauf nie doppelt gezählt wird. Trenne die eine Verbindung, bevor du eine andere herstellst.
• Mollie erlaubt drei Live-Webhooks pro Organisation. Rekomi braucht einen davon. Sind alle drei Plätze schon belegt, klappt das Verbinden trotzdem, aber ohne Webhook: Rekomi erfasst Zahlungen, Erstattungen und Rückbuchungen dann über die Prüfung alle 30 Minuten, Verkäufe erscheinen also innerhalb von etwa einer halben Stunde statt innerhalb von Sekunden. Für die Zustellung per Webhook gibst du in Mollie unter Developers > Webhooks einen Platz frei und verbindest neu.
• Ein Website-Profil pro Workspace. Eine Mollie-Organisation kann mehrere Website-Profile betreiben; Rekomi verknüpft eines. Sieht dein Token mehr als eines, fragt das Verbinden nach deiner Wahl, und Zahlungen aus den anderen Profilen werden mit einem Protokolleintrag übersprungen. Für ein zweites Profil nutzt du einen zweiten Rekomi-Workspace. Das Token wird trotzdem für alle Profile erstellt (Mollie lehnt ein Token für ein einzelnes Profil mit 403 ab), und jeder Workspace bekommt seinen eigenen Webhook-Namen, sodass sich zwei Workspaces eine Mollie-Organisation teilen können. Hast du das falsche Profil verknüpft, sagt dir die Einrichtungsseite das und bietet einen Wechsel an; siehe Zahlungen auf einem anderen Profil.
• Der gehostete Checkout führt keine Skripte aus. Die Checkout-Seite von Mollie erlaubt nur Branding, deshalb gehört das Rekomi-Tracking-Skript auf deine eigene Website (Preis-, Anmelde- und Danke-Seiten). Das Klick-Cookie übersteht den Umweg auf deiner Domain, und der Verkauf selbst wird über den Webhook gutgeschrieben. Die Weiterleitung von Mollie zurück auf deine Website enthält nichts über die Zahlung, versuche also nicht, den Verkauf im Browser zu erfassen.
• Zahlungslinks tragen keine Metadaten. Eine Zahlung über einen Zahlungslink von Mollie lässt sich nicht mit rekomi_ref versehen. Sie wird nur über die Attributionshistorie des Kunden zugeordnet oder, wenn die Zahlung die E-Mail-Adresse des Käufers enthält, über den Abgleich mit der Lead-E-Mail.
• Zahlungen am Point of Sale werden nur mit Eintrag erfasst. Eine Zahlung an einem Mollie-Terminal hat keinen Klickpfad, deshalb überspringt Rekomi sie mit einem Protokolleintrag, es sei denn, deine Kassenintegration setzt metadata.rekomi_ref oder metadata.rekomi_coupon. Dann wird sie wie jede andere Zahlung erfasst.
• Mollie hat keine Gutscheincodes. Es gibt in Mollie nirgends ein Objekt für Rabattcodes, deshalb funktioniert die Attribution per Gutschein pro Affiliate über diese Anbindung nur über metadata.rekomi_coupon, gesetzt von deinem Checkout. Verkaufst du über WooCommerce, Shopify oder Wix mit Mollie darunter, verwaltet der Shop die Gutscheine und Bestellungen. Verbinde dann die eigene Rekomi-Integration des Shops (das WooCommerce-Plugin, die Shopify-App oder die Wix-App) statt dieser Anbindung. Bei Shopware, Magento oder PrestaShop legt das Mollie-Plugin des Shops die Zahlung für dich an, es gibt also keinen Ort, an dem du die Empfehlung setzen könntest. Tracke diese Shops stattdessen mit dem Rekomi-Skript auf deinen Seiten und der S2S-API aus deinem Backend.
• Neu verbinden statt das Secret zu rollen. Das Dashboard von Mollie bietet bei Webhooks die Aktion „Roll secret“. Damit wird das Secret, das Rekomi gespeichert hat, innerhalb eines Tages ungültig, und danach scheitern Zustellungen an der Signaturprüfung, bis du neu verbindest (die Prüfung alle 30 Minuten erfasst Zahlungen in der Zwischenzeit weiter). Glaubst du, dass das Secret kompromittiert ist, verbinde in Rekomi neu: Dabei wird der alte Webhook gelöscht und ein neuer mit neuem Secret angelegt.
• Bearbeite die Ereignisliste des Webhooks nicht im Dashboard von Mollie. Rekomi registriert den Webhook mit den Ereignissen, die gewährt wurden. Entfernst du eines davon, hören diese Zustellungen stillschweigend auf. Der Gesundheitscheck vergleicht die Ereignisliste des Webhooks mit dem, was beim Verbinden gewährt wurde, und markiert die Verbindung als unterbrochen, wenn Ereignisse entfernt wurden; neu verbinden stellt sie wieder her.
• Ein Webhook, der dauerhaft scheitert, wird gesperrt. Kann Mollie Rekomi etwa 24 Stunden lang nicht erreichen, markiert es den Webhook als gesperrt, stellt nichts mehr zu und schickt dir eine E-Mail. Aktiviere ihn in Mollie unter Developers > Webhooks wieder oder verbinde in Rekomi neu; die Prüfung alle 30 Minuten erfasst, was in der Zwischenzeit gefehlt hat. Die Wiederholungsstaffel von Mollie umfasst zehn Versuche über 26 Stunden.
• Normale API-Schlüssel werden abgelehnt. Sie können keine Webhooks verwalten, deshalb stoppt das Verbinden, bevor etwas gespeichert wird, und fragt nach einem Advanced Access Token.

Zahlungen auf einem anderen Profil

Mollie sendet jedes Ereignis deiner Organisation an jeden Webhook darin, deshalb bekommt der Rekomi-Webhook auch Zahlungen auf den anderen Website-Profilen deiner Organisation mit. Rekomi gleicht jede Zahlung mit dem verbundenen Profil ab und überspringt die, die zu einem anderen Profil gehören, mit einem Protokolleintrag und ohne etwas zu erfassen.

Hat das verbundene Profil in den letzten 30 Tagen keine Zahlungen erfasst, ein anderes Profil derselben Organisation aber schon, zeigt Rekomi unter /dashboard/setup/mollie einen Hinweis mit dem Titel „Zahlungen landen auf einem anderen Mollie-Profil.“, und derselbe Hinweis erscheint auch als Vorschlag in deinem Dashboard. Der Hinweis nennt beide Profile und die Zahl der Zahlungen, die auf dem anderen Profil gesehen wurden. Meist heißt das, dass beim Verbinden das falsche Profil verknüpft wurde, zum Beispiel ein altes Profil, das keine Zahlungen mehr annimmt.

Der Hinweis hat zwei Aktionen. Wechseln verknüpft diesen Workspace neu mit dem anderen Profil, und Rekomi verfolgt ab diesem Moment die Zahlungen dieses Profils; das Token, der Webhook und deine Historie bleiben, wie sie sind. Zahlungen auf dem anderen Profil vor dem Wechsel wurden damals übersprungen und bleiben unerfasst. Ausblenden blendet den Hinweis für alle im Workspace aus und behält das aktuelle Profil. Für den Wechsel brauchst du in Rekomi die Rolle Admin.

Betreibst du absichtlich zwei Rekomi-Workspaces auf einer Mollie-Organisation, einen pro Profil, ist das in Ordnung, und es erscheint kein Hinweis: Ein Profil, das ein anderer Workspace verbunden hat, zählt nie als falsches Profil.

Den Ablauf testen

Der Testmodus von Mollie kennt nur EUR und ist vom Live-Modus getrennt, und die Produktivverbindung von Rekomi arbeitet nur im Live-Modus. Ein vollständiger Probelauf mit Testzahlungen findet deshalb in einer Staging-Umgebung statt. Im Testmodus wird der gehostete Checkout zu einer Statusauswahl (bezahlt, fehlgeschlagen, abgebrochen, abgelaufen), eine bezahlte Testzahlung bietet eine Seite changePaymentState, über die sich auch Erstattungen und Rückbuchungen dafür anlegen lassen, und Webhooks werden genau wie im Live-Modus ausgelöst. Was du in der Produktion prüfen kannst, ohne Geld auszugeben:

1. Verbinde und klicke dann auf der Einrichtungsseite auf Verbindung prüfen: Das liest den Webhook, den Rekomi angelegt hat (Gültigkeit des Tokens, Status des Webhooks und seine Ereignisliste, alles in einer Prüfung). Ist die Prüfung in Ordnung, bittet Rekomi Mollie außerdem, ein Testereignis zu senden, und die Seite zeigt „Testereignis zugestellt.“, sobald es ankommt. Läuft deine Verbindung über die Prüfung alle 30 Minuten (kein freier Webhook-Platz bei Mollie), gibt es keinen Webhook zum Lesen; die Prüfung kontrolliert dann stattdessen das Token gegen dein Mollie-Konto.
2. Prüfe, dass der Webhook in deinem Mollie-Dashboard unter Developers > Webhooks erscheint, mit dem Namen „Rekomi“, gefolgt von einer kurzen ID für deinen Workspace, und auf die URL deines Workspaces zeigt.
3. Tätige einen echten Kauf über einen Affiliate-Link, bei dem ?via= auf den Link-Slug eines freigegebenen Affiliates gesetzt ist, mit metadata.rekomi_ref in der Zahlung, prüfe die Conversion innerhalb einer Minute im Tab Performance der Kampagne, erstatte den Kauf dann und prüfe, dass die Provision zurückgeholt wird (innerhalb einer Minute, wo Erstattungsereignisse gewährt sind, sonst innerhalb von 30 Minuten).

Fehlerbehebung

Das Verbinden meldet, dass das Token die falsche Art ist oder eine Berechtigung fehlt. Du hast einen normalen API-Schlüssel eingefügt oder ein Advanced Access Token, dem eine der sieben Berechtigungen fehlt. Erstelle unter Developers > API keys ein Advanced Access Token mit angehakten webhooks.read, webhooks.write, payments.read, refunds.read, profiles.read, organizations.read und customers.read und verbinde damit. Nur ein Admin kann eines erstellen.

Das Verbinden fragt nach einem Website-Profil. Dein Token sieht mehr als ein Profil. Wähle das, dessen Checkout du tracken willst; die anderen werden übersprungen. Beschränke das Token nicht auf dieses eine Profil, um die Frage zu umgehen: Mollie beantwortet ein Token für ein einzelnes Profil bei den Aufrufen zum Verbinden mit 403. Lass das Token für alle Profile erstellt und wähle das Profil hier.

Das Verbinden scheitert, und die Meldung sagt, Mollie habe mit 403 geantwortet. Das Access Token wurde für ein einzelnes Website-Profil erstellt. Mollie dokumentiert das nicht, aber ein auf ein Profil beschränktes Token wird bei den Aufrufen, die Rekomi zum Verbinden macht, mit 403 abgelehnt, selbst wenn alle sieben Berechtigungen angehakt sind. Erstelle ein neues Advanced Access Token für alle Profile der Organisation, mit denselben sieben Berechtigungen und im Live-Modus, und verbinde damit; das zu verfolgende Profil wählst du nach dem Einfügen in Rekomi.

Das Verbinden scheitert mit „A webhook with that name already exists“. Mollie verlangt eindeutige Webhook-Namen innerhalb einer Organisation. Rekomi nennt seinen Webhook „Rekomi“, gefolgt von einer kurzen ID für deinen Workspace, sodass zwei Workspaces auf einer Organisation jeweils ihren eigenen Namen bekommen. Siehst du die Meldung trotzdem, ist ein Webhook mit diesem Namen von einem früheren Verbinden übrig (Rekomi löscht seinen vorherigen Webhook, bevor es einen neuen anlegt, kann das aber nicht, wenn Mollie nicht erreichbar ist oder das alte Token nicht mehr funktioniert). Lösche den übrig gebliebenen Rekomi-Webhook in Mollie unter Developers > Webhooks und verbinde erneut.

Die Einrichtungsseite sagt, dass Rekomi über die Prüfung alle 30 Minuten erfasst statt über einen Webhook. Mollie erlaubt drei Live-Webhooks pro Organisation, und beim Verbinden waren alle drei belegt. Verkäufe werden trotzdem erfasst, mit bis zu 30 Minuten Verzögerung, und „Verbindung prüfen“ kontrolliert das Token gegen dein Mollie-Konto statt eines Webhooks. Für die Zustellung per Webhook löschst du einen ungenutzten Webhook in Mollie unter Developers > Webhooks und verbindest neu.

Banner oder E-Mail „Deine Mollie-Verbindung ist unterbrochen.“ Entweder wird das gespeicherte Token nicht mehr akzeptiert (in Mollie widerrufen oder bearbeitet), der Webhook wurde bei Mollie gesperrt, deaktiviert oder gelöscht, oder seine Ereignisliste wurde so bearbeitet, dass er nicht mehr alles abonniert, was Rekomi gewährt wurde. Die Meldung sagt, welcher Fall vorliegt. Bei einem gesperrten oder deaktivierten Webhook aktivierst du ihn in Mollie unter Developers > Webhooks wieder oder verbindest neu. In allen anderen Fällen erstellst du ein neues Advanced Access Token und verbindest unter /dashboard/setup/mollie neu; deine Tracking-Historie bleibt erhalten.

Verkäufe kommen an, aber kein Affiliate erhält eine Gutschrift. Die Zahlung hat Rekomi erreicht, aber ohne rekomi_ref, ohne rekomi_coupon und ohne eine E-Mail-Adresse, die zu einem Lead passt. Prüfe, dass dein Aufruf zum Anlegen der Zahlung oder des Abonnements metadata.rekomi_ref setzt, dass das Tracking-Skript lief, bevor der Käufer weitergeklickt hat (damit window.Rekomi.getReferral() einen Wert hatte), und bei Abläufen mit Anmeldung zuerst, dass der Lead auf deiner Website erfasst wurde und, bei einer Einmalzahlung ohne Mollie-Kunden, dass billingAddress.email übergeben wird. Hast du Mollie verbunden, bevor customers.read auf der Liste für das Token stand, kann dein Token bei Abo-Zahlungen die E-Mail-Adresse des Kunden nicht lesen. Erstelle dann ein neues Advanced Access Token mit allen sieben Berechtigungen, verbinde neu und übergib bis dahin billingAddress.email bei den Zahlungen, die du selbst anlegst.

Eine Erstattung oder Rückbuchung wurde nicht innerhalb einer Minute zurückgeholt. Höchstwahrscheinlich sind Ereignisse zu Erstattungen und Rückbuchungen für dein Mollie-Konto noch nicht aktiviert (bei manchen Konten sind sie in der Beta). Die Prüfung alle 30 Minuten holt sie zurück. Fehlt sie nach einer Stunde immer noch, schreib uns im In-App-Messenger mit der Erstattungs-ID (re_...) oder der Rückbuchungs-ID (chb_...).

Eine Zahlung von einem anderen Website-Profil wurde nicht erfasst. Rekomi verfolgt ein Website-Profil pro Workspace. Zahlungen von anderen Profilen derselben Organisation werden bewusst übersprungen; verbinde für ein zweites Profil einen zweiten Workspace. Liegen alle deine Zahlungen auf diesem anderen Profil, zeigt die Einrichtungsseite einen Hinweis und bietet an, das verfolgte Profil zu wechseln; siehe Zahlungen auf einem anderen Profil.

Nach einem Ausfall fehlt eine Conversion. Mollie wiederholt jede Zustellung bis zu zehnmal über 26 Stunden, und die Prüfung alle 30 Minuten holt alles nach, was die Wiederholungen verpasst haben. Eine Zahlung erscheint also normalerweise innerhalb einer halben Stunde, nachdem Rekomi wieder erreichbar ist. Fehlt sie danach immer noch, schreib uns im In-App-Messenger mit der Zahlungs-ID (tr_...).

Verwandte Seiten

• Referenz der S2S-Tracking-API
• Checkout-Tracking ohne Code und ohne Stripe
• Umgang mit Erstattungen