Dokumentation

Mit blockwallets nehmen Sie USDT und USDC an, außerdem BTC, LTC und die nativen Coins der Netzwerke (in US-Dollar gutgeschrieben, zu einem festgelegten Kurs). Jede der folgenden Integrationen erzeugt dieselbe Art von Rechnung auf demselben gehosteten Checkout, mit denselben Bestätigungen, Gebühren und demselben Guthaben; sie unterscheiden sich nur darin, wie Ihr System mit uns spricht. Wählen Sie die passende aus und folgen Sie ihrer Seite.

Integration wählen

Gruppiert danach, wo Sie anfangen. Jede Karte öffnet die vollständige Anleitung.

Ohne Code

Zahlungen direkt im Händler-Dashboard annehmen; es muss nichts installiert werden.

Neue API-Integration

Sie schreiben die Integration von Grund auf.

Wechsel von einem anderen Gateway

Ihr Code bleibt: kompatible APIs, Sie ändern nur die Base-URL und die Schlüssel.

KI integrieren lassen

Für Leute, die keinen Code schreiben, aber ein KI-Coding-Tool nutzen.

Tools

Debugging-Hilfe, die in Ihrem Browser läuft.

Cryptomus-kompatibel oder nativ?

Beide erzeugen dieselben Rechnungen auf demselben Checkout, mit denselben Gebühren und demselben Guthaben. Der Unterschied liegt im Anfrage-Stil, im Webhook-Format und darin, wie Sie an die Zugangsdaten kommen.

Fangen Sie neu an? Nehmen Sie die native REST-API: Beträge in Cent, idempotentes ref, Webhook-Signaturen mit Zeitstempel und Keys, die Sie selbst im Dashboard erzeugen. Sie nutzen bereits Cryptomus oder möchten ein vorhandenes Cryptomus-SDK oder -Plugin weiterverwenden? Nehmen Sie die Cryptomus-kompatible API.

Schnellstart

Von null zur Testzahlung in fünf Schritten (Cryptomus-kompatible API; die anderen APIs folgen denselben Schritten mit ihren eigenen Zugangsdaten).

1. Beantragen Sie den Zugang auf der Startseite. Nach der Freigabe melden Sie sich im Händler-Dashboard an.
2. Öffnen Sie im Dashboard „Entwickler › Integration & Keys“, erzeugen Sie in der Spalte Test einen merchant und API key und tragen Sie Ihre Website-Domains ein.
3. Ihr Server erstellt eine Rechnung mit POST /v1/payment und leitet den Kunden auf result.url weiter.
4. Bezahlen Sie sie mit „Zahlung simulieren“ im Checkout und prüfen Sie dann, ob Ihr Webhook-Handler sign verifiziert und nach payment_amount_usd gutschreibt.
5. Wechseln Sie zu den Zugangsdaten in der Spalte Live und zahlen Sie einmal einen kleinen echten Betrag („Zahlung ausprobieren“ auf der Startseite des Dashboards).

POST https://blockwallets.io/v1/payment
merchant: <merchant>
sign: md5(base64(body) + API key)
Content-Type: application/json

{
  "amount": "42.00",
  "currency": "USD",
  "order_id": "order_1042",
  "url_callback": "https://shop.example/webhooks/crypto",
  "url_return": "https://shop.example/cart",
  "url_success": "https://shop.example/thanks?order=1042"
}

Code in Node.js, PHP und Python für jeden Schritt steht in der Dokumentation der Cryptomus-kompatiblen API; wenn Sie es lieber von einer KI erledigen lassen, beginnen Sie mit dem Prompt-Generator.

Zahlungslinks (ohne Code)

Händler-Dashboard → „Zahlungen › Zahlungslinks“ → Beschreibung und Betrag eingeben (ein Netzwerk festlegen oder den Kunden wählen lassen) → erstellen. Jeder Link hat eine URL und einen QR-Code.

• Jedes Mal, wenn jemand den Link öffnet, wird eine neue Rechnung erstellt, ein Link ist also wiederverwendbar (z. B. „Mitgliedschaft $99“).
• Jede Zahlung erscheint unter „Zahlungen › Zahlungseingänge“; zahlen Sie sie unter „Finanzen › Guthaben & Auszahlung“ auf Ihre Wallet aus.
• Wenn Sie unter „Entwickler › Integration & Keys“ Zugangsdaten und eine Webhook-URL angelegt haben, werden auch Zahlungen über Links gemeldet, im Cryptomus-kompatiblen Webhook-Format.
• Um nichts mehr anzunehmen, klicken Sie auf „Deaktivieren“, und der Link funktioniert sofort nicht mehr.

POS für Geschäfte

Für Ladentheken und Stände: Händler-Dashboard → „Zahlungen › POS-Kasse“ → ein Terminal öffnen und einen POS-Link erhalten. Mitarbeiter öffnen ihn auf dem Handy oder Tablet und tippen einen Betrag ein, dann erscheint ein Zahlungs-QR-Code; sobald der Kunde zahlt, zeigt der Bildschirm „Paid“.

• Eine POS-Rechnung ist 30 Minuten gültig. Zahlungen gehen auf Ihr Guthaben und erscheinen unter „Zahlungen › Zahlungseingänge“, und Sie werden an Ihrer Webhook-URL benachrichtigt, genau wie bei Zahlungslinks.
• Ein POS-Link kann nur Zahlungen annehmen: Er sieht weder Ihr Guthaben noch Auszahlungen, andere Bestellungen, Einstellungen oder Zugangsdaten.
• Gerät verloren oder Mitarbeiter ausgeschieden? Sperren Sie das Terminal im Dashboard, und sein Link funktioniert sofort nicht mehr.

Button einbetten

Händler-Dashboard → „Zahlungen › Zahlungslinks“ → „Button einbetten“: Text, Farbe, Größe und Form wählen und den Code kopieren. Ein Klick auf den Button öffnet den Checkout dieses Zahlungslinks.

• Reines HTML: ein gestalteter Link ohne Script, funktioniert also überall, wo Sie HTML einfügen können (Website-Baukästen, Foren, E-Mail-Signaturen).
• Mit Script: Fügen Sie data-blockwallets und ein /embed.js-Tag hinzu; am Desktop öffnet sich der Checkout in einem kleinen zentrierten Fenster, auf dem Handy normal.
• Das Script sendet keine Anfragen, setzt keine Cookies und fügt kein iframe hinzu. Blockiert die Seite es, bleibt der Button ein ganz normaler, funktionierender Link.

Ersetzen Sie in den Snippets unten /l/pl_… durch die Adresse Ihres eigenen Zahlungslinks.

Reines HTML

<a href="https://blockwallets.io/l/pl_…" target="_blank" rel="noopener nofollow"
   style="display:inline-flex;align-items:center;height:44px;padding:0 22px;border-radius:999px;background:#1f5a3d;color:#ffffff;font:600 16px/1 sans-serif;text-decoration:none">Pay with crypto</a>

HTML + Script

<a href="https://blockwallets.io/l/pl_…" target="_blank" rel="noopener nofollow"
   data-blockwallets data-color="green" data-size="m" data-shape="pill">Pay with crypto</a>
<script src="https://blockwallets.io/embed.js" async></script>