Anwendungsfälle

Krypto-Zahlungen in einem Onlineshop akzeptieren, ohne Plugin

Ein Onlineshop akzeptiert Krypto mit Crypto Merchant, indem er über die REST-API eine Rechnung pro Bestellung erstellt und den Kunden auf die gehostete Bezahlseite der Rechnung schickt. Der Kunde wählt einen Coin, bezahlt den genauen Betrag zu einem für diese Rechnung fixierten Kurs, und Ihr Server versendet die Bestellung, wenn der signierte invoice.paid-Webhook eintrifft. Die Gebühr beträgt 1 % pro bezahlter Rechnung. Es gibt kein Plugin für WooCommerce, Shopify oder Magento: Die Integration besteht aus einem API-Aufruf und einem Webhook-Endpunkt.

Aktualisiert am 6. November 2026

Alles auf dieser Seite beschreibt, wie Crypto Merchant heute funktioniert, so wie es in der API-Referenz, der Checkout-Dokumentation und unter Preise festgehalten ist. Nichts hier ist eine Aussage über andere Gateways.

Auf einen Blick

Thema	So funktioniert es
Wie Kunden bezahlen	Auf einer gehosteten Rechnungsseite: Sie wählen einen Coin und ein Netzwerk aus denen, die Sie akzeptieren, und sehen den genauen Betrag und eine für diese Rechnung erstellte Einzahlungsadresse, mit QR-Code und Countdown.
Was Sie bauen	Ein `POST /invoices`-Aufruf, wenn der Kunde Krypto wählt, und ein HTTPS-Endpunkt für Webhooks. Jede Sprache und jedes Framework, das eine HTTPS-Anfrage stellen kann.
Wann versenden	Beim Ereignis `invoice.paid`, nachdem die Zahlung ihre Bestätigungen hat. Niemals bei `invoice.confirming`.
Falsche Beträge	Eine Zahlung, bei der höchstens Ihre Toleranz fehlt, gilt als bezahlt. Fehlt mehr, wird die Rechnung `underpaid`: Der Kunde kann den Rest nachzahlen oder sich das Gesendete zurückholen. Eine Überzahlung gilt trotzdem als bezahlt, und der Mehrbetrag wird für den Kunden gehalten.
Preiswährung	Standardmäßig US-Dollar oder eine andere unterstützte Währung wie EUR, GBP, TRY oder BRL; der Coin-Betrag wird aus aktuellen Kursen berechnet, wenn der Kunde den Coin wählt.
Plugins	Keine. Der Ablauf unten funktioniert mit jedem Warenkorb oder eigenen Checkout, der eine API aufrufen kann.

Wie funktioniert es, Schritt für Schritt?

Von dem Moment, in dem ein Kunde „Mit Krypto bezahlen“ wählt, bis die Bestellung Ihr Lager verlässt:

1
Die Rechnung im Checkout erstellen
Wenn der Kunde Krypto wählt, ruft Ihr Server POST /invoices auf, mit der Bestellsumme, Ihrer order_id, der E-Mail-Adresse des Kunden, einer redirect_url zurück zu Ihrer Dankesseite und beliebigen metadata, die Sie zurückerhalten möchten. Die Antwort ist die Rechnung mit einer checkout_url.
2
Den Kunden auf die Rechnungsseite schicken
Leiten Sie zur checkout_url weiter. Die Seite listet die Coins auf, die Sie akzeptieren; wählt der Kunde einen, wird der Betrag in diesem Coin aus aktuellen Kursen berechnet und fixiert, und eine für diese Rechnung erstellte Einzahlungsadresse wird mit QR-Code angezeigt. Die Rechnung bleibt für die von Ihnen festgelegte Zeit offen, standardmäßig 30 Minuten.
3
Die signierten Webhooks empfangen
Ihr Endpunkt erhält invoice.confirming, wenn die Zahlung on-chain erkannt wird, und invoice.paid, sobald sie genügend Bestätigungen hat. Prüfen Sie den CM-Signature-Header, speichern Sie das Ereignis, antworten Sie innerhalb von 10 Sekunden mit 2xx, und geben Sie die Bestellung dann anhand Ihrer gespeicherten Kopie frei. Ereignisse können zweimal eintreffen: Nutzen Sie die id des Ereignisses, um nur einmal zu versenden.
4
Die drei Sonderfälle behandeln
invoice.expired: Es ist keine Zahlung rechtzeitig angekommen, bieten Sie also eine neue Rechnung an. invoice.underpaid: Der Kunde kann den Rest an dieselbe Adresse senden oder sich auf der Rechnungsseite eine Erstattung holen. Eine überbezahlte Rechnung ist trotzdem bezahlt; der Mehrbetrag wird für den Kunden gehalten, der ihn auf der Rechnungsseite abheben kann.
5
Ausgezahlt werden
Bestätigte Zahlungen werden Ihrem Guthaben abzüglich 1 % gutgeschrieben und in die Pool-Wallet Ihres Unternehmens zusammengeführt. Zahlen Sie jederzeit an Ihre eigenen Adressen aus, jeden Coin, wie er ist, oder alles getauscht in einen Ziel-Coin.

Der eine API-Aufruf, den es braucht

Die Rechnung im Checkout erstellen

curl https://cryptomerchant.online/api/v1/invoices \
  -H "Authorization: Bearer $CM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "64.00",
    "currency": "USD",
    "order_id": "ORD-20931",
    "description": "Order ORD-20931",
    "customer_email": "[email protected]",
    "redirect_url": "https://yourstore.example/orders/20931/thanks",
    "metadata": { "cart": "20931" }
  }'

# 201 → { "id": "inv_…", "status": "open", "checkout_url": "https://cryptomerchant.online/pay/i/inv_…", … }
# Send the customer to checkout_url. Ship on the "invoice.paid" webhook.

Was kostet es?

1 % jeder bezahlten Rechnung, abgezogen, wenn die Zahlung Ihrem Guthaben gutgeschrieben wird. Es gibt keine Einrichtungsgebühr, keine Monatsgebühr und keine Zahlung für die Freischaltung; abgelaufene und stornierte Rechnungen kosten nichts. Für das Bewegen von Coins (Zusammenführungen, Tauschvorgänge und Auszahlungen) fällt eine Gas-Gebühr an, die aus Ihrem Gas-Guthaben bezahlt wird, wenn Sie eines aufladen, und andernfalls von den bewegten Coins abgezogen wird. Kunden zahlen außerdem bei jeder Rechnung eine Gas-Gebühr: Sie wird auf den zu sendenden Betrag aufgeschlagen, im Checkout angezeigt und beträgt nie mehr als 5 $. Tauschkurse enthalten eine Servicemarge von 1 %. Alle Kosten stehen in einer Tabelle unter Preise.

Was Crypto Merchant hier nicht tut

Kein Shop-Plugin. Es gibt kein Modul für WooCommerce, Shopify, Magento, PrestaShop oder OpenCart. Sie fügen den API-Aufruf selbst hinzu oder teilen Ihre Bezahlseite und Zahlungslinks.
Keine automatischen Erstattungen und kein Erstattungsaufruf in der API. Eine bestätigte Krypto-Zahlung ist endgültig, eine Erstattung ist also ein neuer Transfer. Bei einer Rücksendung erstellt ein Admin im Portal aus der abgeschlossenen Zahlung einen privaten Erstattungslink; der Kunde gibt seine eigene Adresse ein, die Netzwerkgebühr wird von der Erstattung abgezogen und die Gebühr von 1 % wird nicht zurückgezahlt.
Verwahrend, nur Krypto. Crypto Merchant hält die Schlüssel, bis Sie auszahlen, und Auszahlungen gehen an Ihre eigenen Wallet-Adressen, nicht auf ein Bankkonto.

Für wen ist das?

Shops, die bereits ihren eigenen Checkout betreiben und einen API-Aufruf und einen Webhook hinzufügen können.
Shops, die an Kunden in Ländern verkaufen, in denen Karten schwer zu bekommen sind oder Rückbuchungen schmerzen.
Shops, die in Dollar auspreisen und in USDT oder USDC abrechnen möchten.

Häufige Fragen

Gibt es ein WooCommerce- oder Shopify-Plugin für Crypto Merchant?

Nein. Die Integration besteht aus einem API-Aufruf, der eine Rechnung erstellt, und einem Webhook-Endpunkt, der erfährt, wenn sie bezahlt ist. Wenn ein Plugin unverzichtbar ist, führen die Alternativen-Seiten Gateways auf, die eines haben.

Wie lange dauert es, bis eine Krypto-Zahlung bestätigt ist?

Das hängt vom Netzwerk ab. Jedes Netzwerk hat eine festgelegte Anzahl von Bestätigungen, aufgeführt unter Coins & Netzwerke. Stablecoins auf Tron, Solana, BNB Smart Chain, Polygon, Base und Arbitrum sind meist innerhalb weniger Minuten bestätigt; Bitcoin braucht 2 Bestätigungen, meist etwa 20 Minuten.

Was passiert, wenn der Kunde den falschen Betrag bezahlt?

Fehlt höchstens Ihre Toleranz, gilt die Zahlung als bezahlt. Fehlt mehr, wird die Rechnung unterbezahlt, und der Kunde kann auf der Rechnungsseite den Rest nachzahlen oder sich das Gesendete zurückholen. Eine Überzahlung gilt trotzdem als bezahlt, und der Mehrbetrag wird für den Kunden gehalten, der ihn abheben kann.

Braucht der Kunde ein Konto bei Crypto Merchant?

Nein. Der Kunde braucht nur eine Wallet mit dem Coin, mit dem er bezahlen möchte. Er öffnet die Rechnungsseite, wählt den Coin und sendet den angezeigten Betrag.

Kann ich Bestellungen in Euro oder einer anderen Währung auspreisen?

Ja. Rechnungen werden standardmäßig in US-Dollar ausgepreist, und das Währungsfeld akzeptiert andere unterstützte Währungen wie EUR, GBP, TRY oder BRL. Der Coin-Betrag wird aus aktuellen Kursen berechnet, wenn der Kunde den Coin wählt.

Weitere Anwendungsfälle

Alle Anwendungsfälle

Akzeptieren Sie noch heute Krypto

Kostenlose Einrichtung, keine Dokumente für die Registrierung, 1 % pro bezahlter Rechnung und Auszahlungen, wann immer Sie wollen.

Konto erstellen Doku lesen