# blockwallets-Dokumentation: Wege zur Integration > Wählen Sie eine Integration: Zahlungslinks, POS und Einbettungs-Buttons ohne Code; die Cryptomus-kompatible API oder die native REST API; kompatible APIs für Cryptomus, NOWPayments und Coinbase Commerce; KI-Prompts, AGENTS.md und MCP. > > HTML: https://blockwallets.io/docs?lang=de · English: https://blockwallets.io/docs.md?lang=en ## 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. - [Zahlungslinks](https://blockwallets.io/docs?lang=de#links): Betrag eingeben (oder den Zahler eingeben lassen) und den Link oder QR-Code teilen. Jeder Besuch erzeugt eine neue Rechnung. - [POS für Geschäfte](https://blockwallets.io/docs?lang=de#pos): Mitarbeiter öffnen einen POS-Link auf dem Handy oder Tablet und tippen den Betrag ein, der Kunde scannt den QR-Code. - [Button einbetten](https://blockwallets.io/docs?lang=de#embed): Einen „Bezahlen“- oder „Spenden“-Button in jede Website einfügen: reines HTML oder HTML mit einem Script-Tag. #### Neue API-Integration Sie schreiben die Integration von Grund auf. - [Native REST API](https://blockwallets.io/docs/api?lang=de): Bearer-Key, Beträge in Cent, idempotente `ref`, HMAC-SHA256-Webhooks und eine Events-API. Keys erzeugen Sie selbst im Dashboard. - [Cryptomus-kompatible API](https://blockwallets.io/docs/cryptomus?lang=de): POST + JSON mit md5-Signatur. Zugangsdaten erzeugen Sie selbst im Dashboard, jeder wichtige Endpoint hat ein Panel „Ausprobieren“. #### Wechsel von einem anderen Gateway Ihr Code bleibt: kompatible APIs, Sie ändern nur die Base-URL und die Schlüssel. - [Von Cryptomus](https://blockwallets.io/docs/cryptomus?lang=de#cryptomus): Ersetzen Sie `https://api.cryptomus.com` durch `https://blockwallets.io` und nutzen Sie neue merchant- und API-key-Werte. Pfade, Parameter, `sign` und Webhooks bleiben gleich. - [Von NOWPayments](https://blockwallets.io/docs/nowpayments?lang=de): Ersetzen Sie `https://api.nowpayments.io/v1` durch `https://blockwallets.io/nowpayments/v1` und nutzen Sie einen neuen API key und IPN secret. `x-nowpayments-sig` bleibt gleich. - [Von Coinbase Commerce](https://blockwallets.io/docs/coinbase-commerce?lang=de): Übergeben Sie `https://blockwallets.io/coinbase/` als Base-URL des SDK und nutzen Sie einen neuen API key und webhook shared secret. `X-CC-Webhook-Signature` bleibt gleich. #### KI integrieren lassen Für Leute, die keinen Code schreiben, aber ein KI-Coding-Tool nutzen. - [Prompt-Generator](https://blockwallets.io/docs/ai?lang=de): Wählen Sie Ihre Website, die Zahlungsart und das KI-Tool; kopieren Sie den fertigen Prompt für Claude Code, Codex, Cursor oder ChatGPT. - [AGENTS.md](https://blockwallets.io/agents.md): Integrationsregeln, häufige Fehler und eine Abnahme-Checkliste; im Projektstamm speichern, damit Coding-Agents sie lesen. - [MCP-Server](https://blockwallets.io/docs/mcp?lang=de): Lassen Sie ein KI-Tool diese Dokumentation durchsuchen und direkt Test-Rechnungen erstellen. #### Tools Debugging-Hilfe, die in Ihrem Browser läuft. - [Signaturprüfer](https://blockwallets.io/docs/sign?lang=de): Fügen Sie den Body einer Anfrage oder eines Webhooks ein und sehen Sie jeden Signaturschritt und wo Ihr Ergebnis abweicht. Der API key verlässt Ihren Browser nie. ### 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. | | Cryptomus-kompatibel | Native REST | | --- | --- | --- | | Zugangsdaten | Selbst im Dashboard unter „Entwickler › Integration & Keys“ erzeugen (ein Satz für Live, einer für Test) | Ebenfalls selbst im Dashboard unter „Entwickler › Integration & Keys“ erzeugen: ein Live- und ein Test-Key (`bw_live_…` / `bw_test_…`) samt Webhook-Signaturgeheimnissen | | Anfragen | Jeder Aufruf ist `POST` + JSON, mit den Headern `merchant` und `sign` = `md5(base64(Request-Body) + API key)` | REST (`GET` / `POST`) mit `Authorization: Bearer`; das Key-Präfix bestimmt Live oder Test | | Beträge | Dezimal-Strings wie `"42.00"`, in USD, USDT oder USDC (alle 1:1) | Ganzzahlen in US-Cent, etwa `4200`; nur USD | | Wiederholungen | Dieselbe `order_id` liefert die bestehende Rechnung | Dieselbe `ref` mit denselben Parametern liefert die bestehende Rechnung; andere Parameter ergeben 409 | | Webhooks | Gesendet an die `url_callback` jeder Rechnung; die Signatur ist das Feld `sign` im Body | Gesendet an die im Dashboard hinterlegte Webhook-URL; `X-BW-Signature` = HMAC-SHA256 mit Zeitstempel; Auflisten und erneutes Senden über `/v1/events` | | Statische Adressen | `/v1/wallet`: ein Netzwerk pro Aufruf | `/v1/deposit-accounts`: alle Netzwerke auf einmal für einen Kunden | | Tooling | „Ausprobieren“-Panels, Signaturprüfer, KI-Prompts und MCP-Server; vorhandene Cryptomus-SDKs und -Plugins funktionieren | Diese Referenz und ihre Codebeispiele | 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). - Beantragen Sie den Zugang auf der [Startseite](https://blockwallets.io/?lang=de#join). Nach der Freigabe melden Sie sich im [Händler-Dashboard](https://blockwallets.io/dashboard) an. - Ö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. - Ihr Server erstellt eine Rechnung mit `POST /v1/payment` und leitet den Kunden auf `result.url` weiter. - 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. - Wechseln Sie zu den Zugangsdaten in der Spalte Live und zahlen Sie einmal einen kleinen echten Betrag („Zahlung ausprobieren“ auf der Startseite des Dashboards). ```http POST https://blockwallets.io/v1/payment 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](https://blockwallets.io/docs/cryptomus?lang=de#api); wenn Sie es lieber von einer KI erledigen lassen, beginnen Sie mit dem [Prompt-Generator](https://blockwallets.io/docs/ai?lang=de). ### 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](https://blockwallets.io/docs/cryptomus?lang=de#webhooks). - 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 ```html Pay with crypto ``` #### HTML + Script ```html Pay with crypto ```