Wie Sie Monero (XMR) annehmen

Monero wird anders an QryptoPay angebunden als die übrigen Netzwerke. Deshalb steht hier der komplette Weg in einem Artikel: was vorher fertig sein muss, worin sich die Annahme von XMR von den anderen Währungen unterscheidet, wie Sie Wallet und Node verbinden und wie Sie sich vergewissern, dass das Geld ankommt.

Was Sie vorher brauchen

Die Annahme von Monero ist der letzte Schritt, nicht der erste: Sie wird auf einem bereits laufenden Modul eingerichtet. Zu diesem Zeitpunkt sollte Folgendes bereitstehen:

1. Das Modul QryptoPay ist installiert und ein Merchant angelegt — siehe QryptoPay. Schnellstart.
2. Die Zahlungsseite ist angelegt und unter Ihrer Domain erreichbar — siehe Einrichtung der Zahlungsseite von QryptoPay.
3. Die Shop-Integration ist eingerichtet und bis zur Testzahlung geführt — Terminal-Tokens, Zahlungslinks und Webhook; siehe Shop-Integration mit QryptoPay.
4. In der Lizenz ist die Position Monero enthalten — siehe Lizenz verwalten.

⚠️ Ohne die Lizenzposition erscheint Monero nicht in der Währungsliste

Die Wallet lässt sich trotzdem anlegen und sie funktioniert auch — dem Kunden wird Monero auf der Zahlungsseite aber nicht angeboten. Taucht XMR in der Währungsliste des Merchants nicht auf, beginnen Sie die Prüfung bei der Lizenz.

Fehlt einer der ersten drei Punkte, kehren Sie zum entsprechenden Artikel zurück: Ohne Zahlungsseite und Webhook funktioniert die Annahme in keiner Währung, und Monero ist da keine Ausnahme.

Worin sich die Annahme von Monero unterscheidet

Netzwerk	Was Sie im Panel eingeben	Wer ausgeben kann	Auszahlungen und Sammeln
Bitcoin, Litecoin	erweiterter öffentlicher Schlüssel	nur Sie, in Ihrer eigenen App	nicht nötig: Das Geld ist bereits Ihres
Ethereum, Tron	privater Schlüssel	das Panel, ab Ihrer Auszahlungsschwelle	ja
Monero	Hauptadresse und privater View-Key	nur Sie, in Ihrer eigenen App	nicht nötig: Das Geld ist bereits Ihres

Das Panel bekommt von Ihnen keinen Schlüssel, mit dem sich Geld ausgeben lässt, sondern einen, mit dem sich nur zusehen lässt: Es sieht eingehende Überweisungen, rechnet sie ins Guthaben ein und schließt Rechnungen damit ab — verfügen kann es über das Geld nicht. Das Geld Ihrer Kunden liegt dabei sofort auf Ihrer Wallet; von Zwischenadressen muss nichts eingesammelt werden.

Deshalb gibt es bei Monero im Panel weder ein Auszahlungs-Wallet noch eine Auszahlungsschwelle oder eine Netzwerkgebühren-Reserve: Das Panel hat nichts auszugeben.

Schritt 1. Wallet verbinden

Was Sie aus Ihrer Wallet brauchen

Eine Monero-Wallet legen Sie in jeder App an, der Sie vertrauen — etwa in der offiziellen Monero GUI Wallet oder in der mobilen Cake Wallet. Das Panel braucht daraus diese Werte:

• die Hauptadresse — die öffentliche Adresse Ihrer Wallet, 95 Zeichen, beginnt mit 4;
• den privaten View-Key — 64 Hex-Zeichen.

In den meisten Apps stehen die Werte nebeneinander im Bereich mit den Wallet-Schlüsseln: die Adresse auf dem Hauptbildschirm oder im Empfangen-Tab, der View-Key dort, wo die App Ihre Seed-Phrase anzeigt.

⚠️ Verwechseln Sie die Schlüssel nicht

Das Panel braucht genau den View-Key, nicht den privaten Ausgabeschlüssel (private spend key) und nicht die Seed-Phrase. Der View-Key erlaubt es, eingehende Überweisungen zu sehen — mehr nicht; ihn dem Panel zu geben, ist unbedenklich. Ausgabeschlüssel und Seed-Phrase geben vollen Zugriff auf das Geld und werden niemandem weitergegeben.

Was Sie im Panel ausfüllen

Öffnen Sie QryptoPay → Übersicht → Neueste Wallets → „Wallet hinzufügen“ und füllen Sie die Felder aus:

• Name — ein beliebiger Name, 2 bis 64 Zeichen;
• Blockchain — Monero;
• Hauptadresse — die öffentliche Adresse Ihrer Wallet;
• Privater View-Key — der Schlüssel, mit dem das Panel Eingänge sieht;
• Benachrichtigungs-E-Mail — die Adresse für E-Mails zum Zustand der Wallet.

Mehr ist nicht einzugeben: kein Adressformat, kein Auszahlungs-Wallet, kein Startdatum. Ab wann das Panel die Wallet beobachtet, bestimmt es selbst.

ℹ️ Eine Integrated-Adresse funktioniert nicht

Das Panel akzeptiert nur die Hauptadresse der Wallet. Eine Integrated-Adresse (länger, 106 Zeichen) wird beim Speichern abgelehnt.

⚠️ Die Erfassung beginnt mit dem Verbinden

Die Wallet erfasst nur Zahlungen, die nach dem Verbinden eingehen. Alles, was vorher auf dieser Wallet eingegangen ist, sieht das Panel nie: Bei Monero gibt es nichts, womit sich die Historie nachberechnen ließe. Wenn Sie Zahlungen auf einer bereits genutzten Wallet annehmen wollen, bleibt das Geld darauf selbstverständlich Ihres — das Panel zeigt es nur nicht an.

Nach dem Speichern gibt das Panel Ihren Kunden Zahlungsadressen aus dieser Wallet aus — weiter ist nichts einzurichten.

Pro Server läuft eine Monero-Wallet

Monero wird auf einer einzigen Wallet angenommen — die Adressen für Ihre Kunden gibt das Panel selbst daraus aus, eine zweite Wallet ist deshalb nicht nötig. Das gilt für den gesamten Server, nicht für einen einzelnen Merchant: Solange auf dem Server eine aktivierte Monero-Wallet existiert, lässt sich keine weitere anlegen. Im Dialog zum Anlegen ist Monero dann nicht auswählbar, und der Schalter auf der Karte einer deaktivierten Wallet ist gesperrt; in beiden Fällen nennt das Panel den Grund.

Was das in der Praxis bedeutet:

• Die Wallet wechseln geht nur über das Deaktivieren: Schalten Sie den Schalter auf der Karte der aktuellen Wallet aus, danach lässt sich eine neue anlegen.
• Ein zweiter Merchant auf demselben Server kann keine eigene Monero-Wallet anlegen — Monero erscheint in seiner Währungsliste nicht. Brauchen mehrere Merchants Monero mit getrennter Buchführung, ist dafür ein eigener Server nötig.

Schritt 2. Node wählen

Die Blöcke des Netzwerks bezieht das Panel über eine Monero-Node. Standardmäßig wird eine öffentliche Node verwendet — Sie müssen nichts einrichten, die Annahme funktioniert direkt nach dem Hinzufügen der Wallet. Das ist der reguläre Betriebsmodus und keine Übergangslösung: Sie können beliebig lange bei einer öffentlichen Node bleiben.

Betreiben Sie eine eigene Monero-Node, binden Sie sie ein: QryptoPay → „Einstellungen“ → „Nodes“ → Zeile Monero → „Eigene Node einrichten“. Die Adresse Ihrer Node tragen Sie im Feld „Adresse“ ein. Die Felder „Benutzername“ und „Passwort“ brauchen Sie nur, wenn die Node mit einem Login abgesichert ist (monerod --rpc-login) — meist steht die Node in einem geschlossenen Netz, und die Felder bleiben leer. Zur öffentlichen Node kehren Sie an derselben Stelle mit „Eigene Node trennen“ zurück — die Annahme läuft dabei weiter.

Auf derselben Seite steht unter jedem Netzwerk, ob das Panel mit ihm Schritt hält. Erscheint bei Monero eine Warnung, wechseln Sie zuerst die Node — und hilft auch die öffentliche nicht, siehe Statusüberwachung von QryptoPay.

Schritt 3. Annahme mit einer Testzahlung prüfen

Das Test-Terminal eignet sich dafür nicht: Es arbeitet nicht mit echten Netzwerken und braucht keine Wallets. Die Prüfung läuft über das Produktiv-Terminal und erfordert eine echte Überweisung — nehmen Sie den kleinstmöglichen Betrag.

1. Erzeugen Sie in Ihrem Shop einen Zahlungslink und öffnen Sie ihn.
2. Wählen Sie Monero unter den Zahlungsmethoden. Fehlt es in der Liste, prüfen Sie die Lizenzposition und ob die Wallet aktiviert ist.
3. Überweisen Sie den angegebenen Betrag an die Adresse auf der Zahlungsseite, aus Ihrer eigenen Monero-App.
4. Warten Sie die Bestätigungen ab: Eine Zahlung gilt nach 10 Netzwerkbestätigungen als abgeschlossen, das sind etwa 20 Minuten. Der Zähler ist für den Kunden direkt auf der Zahlungsseite sichtbar.
5. Vergewissern Sie sich, dass Ihr Shop die Webhook-Benachrichtigung erhalten hat und die Zahlung beim Merchant im Tab „Zahlungen“ erscheint.

Sind Geld und Benachrichtigung angekommen, ist die Annahme von Monero eingerichtet.

Was das Panel bei Monero nicht anzeigt

• Den Absender der Zahlung. Das Monero-Netzwerk gibt nicht preis, von welcher Adresse das Geld kam — weder dem Panel noch einem Block-Explorer. Ein Eingang lässt sich deshalb nur über die Daten einem Kunden zuordnen, die Ihr Shop beim Anlegen der Zahlung übergeben hat: Bei einer Zahlung ohne Rechnung bleibt der Kunde unbekannt.
• Die Schaltfläche „Guthaben aktualisieren“. Bei Monero gibt es sie nicht — es ist nichts nachzuberechnen, das Panel holt das Guthaben ohnehin aus dem Netzwerk.
• Das Guthaben einer deaktivierten Wallet. Die Karte bleibt leer, bis Sie die Wallet wieder aktivieren; das Geld bleibt davon unberührt.
• Vorgänge zur Wallet. Monero taucht im Vorgangsprotokoll nicht auf: Auszahlungen, Mittelbündelungen und Gebührenüberweisungen gibt es hier nicht.
• Eingänge vor dem Verbinden der Wallet — siehe den Hinweis oben.

Was kommt als Nächstes

• Wallets verwalten — Guthaben, Aktivieren, Deaktivieren und Löschen der Wallet.
• Wie man ein Wallet in QryptoPay hinzufügt — Schlüssel für die übrigen Netzwerke.
• Währungsgebühren in QryptoPay — die Zahlungsgebühr, auch für Monero.
• Statusüberwachung von QryptoPay — erfahren Sie von einem Ausfall, bevor es Ihre Kunden tun.