So akzeptieren Sie Zahlungen in Kryptowährungen auf Ihrer Website
Wählen Sie den Zahlungsablauf, bereiten Sie Empfangsadressen vor und verknüpfen Sie die Zahlungsprüfung mit Ihren Bestellungen.
Aktualisiert:
Um auf Ihrer Website Zahlungen in Kryptowährungen anzunehmen, wählen Sie eine Währung und ein Netzwerk aus, bereiten eine Empfangsadresse vor und legen fest, wie Ihre Website von der Zahlung erfährt. In Cryptanio können Sie mit einem Zahlungslink beginnen, für jede Bestellung eine eigene Rechnung erstellen oder Einzahlungen auf ein internes Guthaben organisieren. Die Mittel gehen an Ihre Adressen. Der Dienst verfolgt die Überweisungen und meldet Änderungen ihres Status.
In dieser Anleitung erfahren Sie, welche Variante zu Ihrer Aufgabe passt und was Sie vor der ersten Zahlung prüfen sollten. USDT und USDC werden im Rahmen dieses gemeinsamen Ablaufs behandelt: Die Wahl des Tokens ist wichtig, bestimmt aber allein noch nicht die Art der Integration.
Wählen Sie eine Zahlungsart
Für einen einmaligen Verkauf oder die Bezahlung einer Dienstleistung eignet sich ein Zahlungslink. Sie verbinden Ihre Adressen mit einem Projekt, erstellen im Konto eine Zahlungsseite, geben den Zahlungszweck an und wählen die verfügbaren Zahlungsoptionen. Anschließend senden Sie dem Kunden den Link. Dafür benötigen Sie weder eine eigene Zahlungsoberfläche noch eine Integration auf Ihrem Server.
Wenn Sie einen Onlineshop oder eine Anwendung mit Bestellungen betreiben, ist eine eigene Rechnung für jeden Kauf praktischer. Eine Rechnung enthält einen Betrag, eine Gültigkeitsdauer und einen eigenen Status. Ihr Server speichert die Zuordnung zur Bestellung und erhält Zahlungsbenachrichtigungen. So können Sie automatisch den Zugang freischalten oder eine bezahlte Bestellung zur Bearbeitung weitergeben.
Ein Einzahlungsablauf ist sinnvoll, wenn Nutzer zunächst ein Guthaben in Ihrem Dienst aufladen und dieses anschließend für Leistungen ausgeben. Cryptanio meldet den Eingang. Die Regeln für Gutschriften, Abbuchungen und die Anzeige des internen Guthabens setzt Ihre Anwendung um.
| Ihre Aufgabe | Womit Sie beginnen |
|---|---|
| Eine einmalige Zahlung per Link erhalten | Zahlungsseite im Konto |
| Die Zahlung für jede Bestellung automatisch zuordnen | Rechnungen und Webhook |
| Einzahlungen auf Nutzerguthaben annehmen | Einzahlungsadressen und Buchführung auf Ihrem Server |
Wenn Ihre Website bisher nur Ihre Leistungen beschreibt, reicht es aus, dort einen Zahlungslink einzufügen. Eine API-Anbindung ist sinnvoll, sobald das Zahlungsergebnis den Zustand Ihres Produkts ändern soll.
Bereiten Sie das Projekt und die Adressen vor
Melden Sie sich im Cryptanio-Konto an und wählen Sie ein Projekt für Ihre Website oder Ihren Dienst. Projekte helfen dabei, Adressen, Einstellungen und Ereignisse verschiedener Produkte voneinander zu trennen.
Bereiten Sie eine Wallet-Adresse für das gewählte Netzwerk vor. Für die hier beschriebene Annahme von USDT oder USDC benötigen Sie eine öffentliche Empfangsadresse. Eine Seed-Phrase oder einen privaten Schlüssel, mit dem sich Mittel ausgeben lassen, müssen Sie für diese Einrichtung nicht übermitteln.
Die Adresse muss nicht nur im Adressbuch gespeichert, sondern auch für den gewählten Dienst mit dem Projekt verbunden sein. Für Rechnungen werden beispielsweise Adressen des Dienstes «Zahlungen» verwendet, für Seiten mit einem Zahlungslink Adressen des Dienstes «Links». Prüfen Sie vor der Annahme von Zahlungen, ob die Verbindung aktiv ist. Eine Adresse in der allgemeinen Liste bedeutet noch nicht, dass der benötigte Dienst sie verwendet.
Richten Sie die Annahme von USDT ein
Wählen Sie für USDT zunächst eine unterstützte Kombination aus Token und Netzwerk. Stimmen Sie diese mit dem Zahler ab, bevor Sie einen Link oder eine Rechnung versenden. Dass in zwei Wallets derselbe Name USDT steht, beweist nicht, dass die Überweisung im selben Netzwerk erfolgt.
Auf der Zahlungsseite müssen drei Angaben eindeutig sein: welcher Vermögenswert zu senden ist, in welchem Netzwerk und an welche Adresse. Zeigen Sie bei einer automatischen Integration den Betrag und die Adresse an, die die jeweilige Rechnung zurückgegeben hat. Der Betrag kann zusätzliche Nachkommastellen enthalten, die zur Unterscheidung von Zahlungen erforderlich sind.
Wenn Sie den Token-Vertrag manuell prüfen, verwenden Sie die Liste der Protokolle und Adressen von Tether. Die Unterstützung eines Netzwerks durch den Emittenten und seine Unterstützung durch den Zahlungsdienst sind zwei unterschiedliche Voraussetzungen. Für die Annahme müssen beide erfüllt sein.
Richten Sie die Annahme von USDC ein
Prüfen Sie auch bei USDC das Netzwerk und den konkret unterstützten Token. Innerhalb eines Netzwerks können Vermögenswerte mit ähnlichen Namen vorkommen, darunter über eine Bridge übertragene Versionen. Orientieren Sie sich an der genauen Kennung des Vermögenswerts in den Einstellungen für den Zahlungsempfang.
Die offiziellen USDC-Adressen sind in der Dokumentation von Circle veröffentlicht. Diese Angaben helfen bei der Prüfung des Tokens, ersetzen aber nicht die Prüfung seiner Verfügbarkeit in Cryptanio.
Wenn Sie sowohl USDT als auch USDC annehmen, zeigen Sie diese als getrennte Zahlungsoptionen an. Eine Überweisung des einen Tokens darf nicht allein wegen eines ähnlichen Werts als Bezahlung einer Rechnung in dem anderen Token gelten.
Legen Sie fest, wie Sie die Bestellung bestätigen
Bei manueller Bearbeitung können Sie Ereignisse im Konto verfolgen und Nachrichten in Telegram oder Discord erhalten. Vergleichen Sie Netzwerk, Vermögenswert, Adresse, tatsächlich eingegangenen Betrag und Überweisungsstatus. Ein Screenshot des Kunden oder das Auftauchen einer unbestätigten Transaktion reicht nicht aus, um die Ware auszuliefern.
Für die automatische Verarbeitung richten Sie einen Webhook ein: eine Benachrichtigung mit Ereignisdaten, die Cryptanio an Ihren Server sendet. Der Server prüft die Signatur der Nachricht, findet die zugehörige Bestellung und gleicht den Rechnungsstatus ab. Die erneute Zustellung desselben Ereignisses darf nicht dazu führen, dass eine Ware oder Gutschrift mehrfach ausgegeben wird.
Eine bestätigte Überweisung und eine vollständig bezahlte Bestellung sind unterschiedliche Tatsachen. Der Kunde kann zu wenig gesendet oder eine abgelaufene Rechnung bezahlt haben. Legen Sie im Voraus fest, wie Sie solche Fälle behandeln. Berücksichtigen Sie außerdem, dass eine Bestätigung bei einer Reorganisation der Blockchain zurückgenommen werden kann.
Prüfen Sie den gesamten Zahlungsablauf
Bevor Sie einen Zahlungsbutton veröffentlichen, prüfen Sie, ob dem Zahler die richtigen Zahlungsdaten angezeigt werden und ob Sie das Ergebnis im richtigen Projekt finden können. Stellen Sie sicher, dass die Benachrichtigung beim gewählten Empfänger ankommt und dass sich der Bestellstatus erst nach den erforderlichen Prüfungen ändert.
Ein Test mit einer echten Überweisung erfordert Mittel und eine Netzwerkgebühr. Wenn Sie ihn durchführen, verwenden Sie eigene Wallets, ein unterstütztes Netzwerk und einen kleinen Betrag unter Beachtung der Einschränkungen der gewählten Methode. Die Prüfung muss mit dem Abgleich des eingegangenen Betrags und des Status enden, nicht schon mit dem Öffnen der Zahlungsseite.
Was Sie über Kosten und Rechnungswährung wissen sollten
Der Bestellbetrag kann in US-Dollar als Rechnungseinheit gespeichert sein, während die Zahlung in der gewählten Kryptowährung erfolgt. Das bedeutet weder, dass Dollar auf einem Bankkonto entgegengenommen werden, noch dass eingegangene Coins automatisch in Fiatgeld getauscht werden.
In der API haben die Felder für den Bestellpreis und den erwarteten Kryptobetrag unterschiedliche Aufgaben. Ihre Übermittlung löst für sich genommen keinen Umtausch von Mitteln aus. Auf der Zahlungsseite benötigt der Kunde genau den Betrag des gewählten Vermögenswerts, den er senden muss.
Die Nutzungsbedingungen und Preise von Cryptanio finden Sie auf der Preisseite. Berücksichtigen Sie zusätzlich die Blockchain-Gebühr: Sie hängt vom Netzwerk und von der Wallet des Absenders ab. Ziehen Sie eine angenommene Gebühr nicht vom Rechnungsbetrag ab, ohne eine ausdrückliche Regel für Unterzahlungen festzulegen.
Welchen nächsten Schritt Sie wählen können
Wenn Sie Zahlungen manuell annehmen möchten, beginnen Sie mit dem Artikel „So erstellen Sie einen Zahlungslink für Kryptowährungen ohne Website und Programmierung“. Für Benachrichtigungen verwenden Sie die Anleitungen zu Telegram und Discord aus dieser Sammlung.
Wenn Ihre Website nach einem Kauf selbstständig die Ware ausliefern soll, lesen Sie den Artikel „So bestätigen Sie die Zahlung einer Bestellung automatisch per Webhook“. Die Beschreibung der unterstützten öffentlichen API finden Sie in der Cryptanio-Dokumentation.