Zum Inhalt springen
Crypto Merchant

Grundlagen

Checkout

Kunden bezahlen auf Seiten, die von Crypto Merchant gehostet werden. Sie brauchen keine Website: Teilen Sie Ihre Bezahlseite oder einen Zahlungslink. Wenn Sie eine Website haben, erstellen Sie Rechnungen mit der API und leiten Kunden auf die Rechnungsseite.

Ihre Bezahlseite

Jeder Shop erhält seine eigene Bezahlseite unter /pay/<store>, wobei <store> der Kurzname Ihres Shops ist. Kunden können dort einen Betrag eingeben oder einen Ihrer Zahlungslinks wählen. Teilen Sie sie überall, wo Sie mit Kunden in Kontakt sind: auf Ihrer Website, in sozialen Profilen, Chats oder E-Mails.

Den Link finden Sie im Portal unter Ihre Bezahlseite.

Die Rechnungsseite

Jede Rechnung hat ihre eigene Seite unter /pay/i/<invoice_id>. Die API gibt diesen Link als checkout_url zurück. Dort kann der Kunde:

  • einen Coin und ein Netzwerk aus denen wählen, die Sie akzeptieren;
  • eine für diese Rechnung erstellte Einzahlungsadresse mit QR-Code sehen sowie den genauen zu sendenden Betrag, zu einem in diesem Moment fixierten Wechselkurs;
  • zu einem anderen Coin wechseln, bis eine Zahlung erkannt wird;
  • live verfolgen, wie sich der Status ändert: von „wartend“ über „wird bestätigt“ bis „bezahlt“.

Jede Rechnung ist nur begrenzte Zeit offen, angezeigt als Countdown. Läuft die Zeit ab, bevor eine Zahlung erkannt wurde, läuft die Rechnung ab. Wenn Sie eine redirect_url festlegen, kann der Kunde nach dem Bezahlen zu Ihrer Website zurückkehren.

Hat ein Kunde bezahlt, die Zahlung wurde aber nicht vor Ablauf der Rechnung erkannt, kann er dies auf der Rechnungsseite melden. Die Adresse wird dann aus der Rotation genommen und weiter beobachtet, und unser Support-Team prüft die Zahlung.

Ein Zahlungslink ist ein wiederverwendbarer Link für ein Produkt, eine Dienstleistung oder eine Spende, unter /pay/l/<link_id>. Geben Sie ihm einen Titel und entweder einen festen Betrag, oder lassen Sie den Betrag leer, damit der Kunde ihn eingibt. Jede Zahlung über einen Link wird zu einer eigenen Rechnung.

Erstellen Sie Links im Portal unter Zahlungslinks oder mit der API.

Linkvorschauen

Wenn Sie einen Zahlungslink oder Ihre Bezahlseite in WhatsApp, Telegram, Instagram, X und ähnlichen Apps teilen, zeigt die App eine Vorschaukarte. Sie enthält den Namen Ihres Shops, Ihre verifizierte Domain, falls Sie eine haben, und die Coins, die Sie akzeptieren. Bei einem Zahlungslink zeigt sie außerdem das Produkt und seinen Preis.

Zahlungslinks werden nicht in Suchmaschinen aufgeführt, sodass ein Link nur die Personen erreicht, mit denen Sie ihn teilen.

Verifizierte Domain

Wenn Sie die Domain Ihrer Website verifiziert haben, zeigen Ihre Bezahlseite, Ihre Zahlungslinks, Rechnungsseiten und Erstattungsseiten sie neben dem Namen Ihres Shops an, zum Beispiel shop.com · verifiziert. Das zeigt Kunden, dass der Shop auf der Seite das DNS dieser Domain kontrolliert. Siehe So verifizieren Sie Ihre Domain.

Wechselkurse

Rechnungen werden in einer Währung wie US-Dollar ausgepreist. Wenn der Kunde einen Coin wählt, wird der Betrag in diesem Coin aus aktuellen Kursen berechnet und fixiert. Stablecoins wie USDT und USDC zählen jeweils als ein US-Dollar. Wird die Zahlung erstmals erkannt, während die Rechnung noch offen ist, gilt der fixierte Kurs.

Kunden, die von einer Börse aus zahlen

Börsen ziehen ihre Abhebungsgebühr meist von dem Betrag ab, den der Kunde eingibt, sodass weniger ankommt als gesendet wurde. Das ist die häufigste Ursache für unterbezahlte Rechnungen. Die Rechnungsseite enthält den Hinweis Sie zahlen von einer Börse aus?, der den Kunden bittet, darauf zu achten, dass der volle Betrag ankommt.

Wenn die Abhebungsgebühr von Binance für diesen Coin und dieses Netzwerk verfügbar ist, zeigt der Hinweis außerdem die Gebühr und den Gesamtbetrag, der bei Binance einzugeben ist. Andere Börsen berechnen ihre eigenen Gebühren, die der Kunde auf dem Abhebungsbildschirm prüfen sollte.

Falscher Coin oder falsches Netzwerk

Kunden zahlen manchmal in einem anderen Coin als dem, den die Rechnung verlangt, oder über ein anderes Netzwerk. Crypto Merchant überwacht jede Rechnungsadresse auf jeden unterstützten Coin, in jedem unterstützten Netzwerk, das diese Adresse verwendet, sodass solche Zahlungen erkannt werden.

Eine EVM-Adresse funktioniert auf Ethereum, BNB Smart Chain, Polygon, Base und Arbitrum One, und wir halten ihren Schlüssel auf allen diesen Netzwerken. USDC, das über Base an eine Rechnung gesendet wird, die USDC auf Ethereum verlangt hat, erreicht also trotzdem eine Adresse, die wir kontrollieren. Tron, Bitcoin, Litecoin, Solana, TON und XRP Ledger haben jeweils ihre eigene Art von Adresse. In diesen Netzwerken gilt dies für einen anderen Coin im selben Netzwerk, zum Beispiel TRX, das an eine Rechnung über USDT auf Tron gesendet wird.

Wann automatisch angerechnet wird

Die Zahlung wird der Rechnung von selbst angerechnet, wenn beides zutrifft:

  • auf die Rechnung wurde bisher nichts anderes gezahlt;
  • die Coins decken den Rechnungsbetrag, innerhalb Ihrer Toleranz für Unterzahlungen.

Die Rechnung wechselt dann zu dem Coin, der tatsächlich gesendet wurde. Die Rechnungsseite teilt dem Kunden mit, in welchem Coin er statt des verlangten bezahlt hat. Bei der Zahlung und in der Zahlungs-E-Mail sehen Sie den Eintrag Angeforderter Coin. In der API ist coin der gezahlte Coin und requested_coin der Coin, den die Rechnung verlangt hat.

Die Coins werden so bewertet:

  • Stablecoins wie USDT und USDC zählen jeweils als ein US-Dollar;
  • derselbe Coin in einem anderen Netzwerk, etwa ETH auf Base für eine Rechnung in ETH auf Ethereum, behält den Kurs, der dem Kunden angezeigt wurde;
  • jeder andere Coin wird zum Marktpreis bei seinem Eingang bewertet.

Das funktioniert auch bei verspäteten Zahlungen: wenn die Rechnung bereits abgelaufen ist, ihre Adresse aber noch überwacht wird, was mindestens 24 Stunden lang der Fall ist.

Kleinere Beträge und verirrte Token

Alles andere ändert die Rechnung nie: eine Teilzahlung in einem anderen Coin, ein zweiter Coin auf einer Rechnung, auf die bereits gezahlt wurde, oder ein verirrter Token. Es wird Ihrem Guthaben wie eine Zahlung ohne Rechnung gutgeschrieben, abzüglich der Gebühr von 1 %, und ein Support-Ticket informiert Sie darüber, sodass Sie es mit dem Kunden klären können. Ein winziger Token, der an die Adresse gesendet wird, kann keine Rechnung übernehmen.

Eine verspätete Zahlung an eine stornierte oder erstattete Rechnung wird genauso behandelt: Sie wird Ihrem Guthaben gutgeschrieben, und Sie erhalten ein Ticket.

Was trotzdem verloren gehen kann

Coins in einem Netzwerk oder in einem Coin, den Crypto Merchant nicht unterstützt, sowie Coins, die an eine andere Adresse als die der Rechnung gesendet werden, können nicht angerechnet werden und können endgültig verloren gehen. Kunden sollten trotzdem den angezeigten Coin im angezeigten Netzwerk senden.

Unterbezahlte Rechnungen

Sie legen in Ihren Einstellungen eine Toleranz für Unterzahlungen fest; wir empfehlen mindestens 1 $. Fehlt bei einer bestätigten Zahlung höchstens der Toleranzbetrag, gilt die Rechnung als bezahlt.

Fehlt mehr, wird die Rechnung unterbezahlt. Der gesendete Betrag wird für den Kunden gehalten, der entweder den Rest an dieselbe Adresse senden oder sich den gesendeten Betrag an eine von ihm angegebene Adresse erstatten lassen kann. Die Netzwerkgebühr für eine Erstattung wird von der Erstattung abgezogen.

Überbezahlte Rechnungen

Sendet ein Kunde mehr, als die Rechnung verlangt, gilt die Rechnung trotzdem als bezahlt. Was mit dem Mehrbetrag geschieht, hängt von seinem Wert ab:

  • Die Rechnung gilt als bezahlt, und der Mehrbetrag wird für den Kunden gehalten. Der Kunde kann ihn auf der Rechnungsseite auf seine eigene Wallet abheben, abzüglich der Netzwerkgebühr für die Übertragung.
  • Bis dahin hält Crypto Merchant ihn für den Kunden. Er wird nicht dem Guthaben des Unternehmens gutgeschrieben und niemals als Gebühr einbehalten.

Erstattungen nach einer Zahlung

Sie können bei einer bezahlten Zahlung Geld zurücksenden, zum Beispiel bei einer Rücksendung oder einer stornierten Bestellung. Öffnen Sie die Zahlung im Portal und verwenden Sie Diese Zahlung erstatten. Nur Admins können das, und sie bestätigen zuerst mit einem neuen Code aus ihrer E-Mail oder Authenticator-App, dass sie es sind.

  • Sie können jeden Betrag bis zu dem erstatten, was Sie von dieser Zahlung behalten haben: was Ihnen nach der Gebühr von 1 % gutgeschrieben wurde, abzüglich früherer Erstattungen und noch offener Erstattungslinks. Die Gebühr von 1 % wird nicht erstattet.
  • Der Betrag wird sofort von Ihrem Guthaben zurückgelegt, sodass er in der Zwischenzeit nicht versehentlich ausgezahlt werden kann.
  • Wenn die Zahlung die E-Mail-Adresse des Kunden enthält, erhält er eine E-Mail mit einem privaten Link. Sie können den Link auch kopieren und selbst senden.
  • Der Kunde öffnet den Link, gibt seine eigene Adresse für diesen Coin und dieses Netzwerk ein, setzt ein Häkchen zur Bestätigung und sendet ab. Die Erstattung wird von Ihrer Pool-Wallet gesendet, und die Netzwerkgebühr wird von der Erstattung abgezogen.
  • Ein Link bleibt 14 Tage lang offen. Wenn der Kunde ihn nicht rechtzeitig einlöst oder Sie ihn stornieren, geht der Betrag automatisch zurück in Ihr Guthaben. Jeder Link kann einmal eingelöst werden.

Bei einer Teilerstattung bleibt die Zahlung bezahlt und zeigt den erstatteten Betrag. Wenn Sie alles erstatten, was Sie behalten haben, wird sie als erstattet markiert. Jede Einlösung sendet einen invoice.refunded-Webhook, und das Rechnungsobjekt zeigt die Summe in refunded_amount.

Da der Kunde die Adresse selbst auf der Erstattungsseite eingibt, muss niemand Adressen in einem Chat austauschen, wo ein Tippfehler oder ein Betrüger die Coins an den falschen Ort schicken kann. Krypto-Überweisungen können nicht rückgängig gemacht werden, daher muss der Kunde eine Adresse eingeben, die er kontrolliert, im angezeigten Netzwerk.

Unterbezahlte Rechnungen haben auf der Rechnungsseite weiterhin ihre eigene Erstattungsoption für den Kunden, und Kunden können dort weiterhin eine Überzahlung abheben, wie oben beschrieben. Anteile, die bereits für Partner einer Umsatzaufteilung zurückgelegt wurden, werden durch eine Erstattung nicht zurückgenommen.

Gebühren

1 % jeder bezahlten Rechnung werden abgezogen, wenn die Zahlung Ihrem Guthaben gutgeschrieben wird. Abgelaufene und stornierte Rechnungen kosten nichts.

Es fällt keine zusätzliche Gebühr an, wenn eine Zahlung angerechnet wird, obwohl sie in einem anderen Coin oder über ein anderes Netzwerk eingegangen ist. Wenn Sie eine Zahlung erstatten, wird die Gebühr von 1 % nicht erstattet, und die Netzwerkgebühr der Erstattung wird von der Erstattung abgezogen.

Der fällige Betrag enthält außerdem eine Gas-Gebühr für die Übertragung dieser Zahlung in Ihre Pool-Wallet, nie mehr als 5 $. In den meisten Netzwerken sind das wenige Cent. USDT auf Tron kostet mehr, weil Tron für jede Token-Übertragung Energie verbrennt. Die Bezahlseite zeigt die Gebühr neben dem Preis an, und die API gibt sie als network_fee_amount und network_fee_usd zurück. Sie deckt die Zusammenführung dieser Zahlung, ist nicht Ihr Umsatz, und es wird keine Zahlungsgebühr darauf erhoben.