# Mit KI integrieren · blockwallets

> Binden Sie blockwallets-Krypto-Zahlungen ein, ohne selbst Code zu schreiben: Wählen Sie Ihre Website und Ihr KI-Tool, kopieren Sie den erzeugten Prompt in Claude Code, Codex, Cursor oder ChatGPT, und die KI integriert anhand der Dokumentation und prüft ihre Arbeit selbst.
>
> HTML: https://blockwallets.io/docs/ai?lang=de · English: https://blockwallets.io/docs/ai.md?lang=en

## Universal-Prompt

```text
Hilf mir, auf meiner Website Krypto-Zahlungen mit blockwallets anzunehmen (Kunden zahlen in USDT, USDC, BTC und mehr; mir wird in US-Dollar gutgeschrieben).

1. Lies zuerst die Dokumentation, statt die API zu raten: https://blockwallets.io/llms-full.txt (vollständige Dokumentation) und https://blockwallets.io/agents.md (Integrationsregeln, häufige Fehler, Abnahme-Checkliste). Sag mir, wenn du sie nicht öffnen kannst.
2. Sieh dir mein Projekt an, sag mir, womit es gebaut ist und wie du integrieren willst, und warte auf mein OK.
3. Standard ist „Rechnung erstellen und auf die Zahlungsseite weiterleiten + Webhook“. Prüfe Webhook-Signaturen immer und dedupliziere Webhooks, weil derselbe zweimal eintreffen kann.
4. Lege die merchant-ID und den API key in Umgebungsvariablen ab und bring zuerst alles mit den Test-Zugangsdaten auf Testnets zum Laufen.
5. Gehe am Ende die Abnahme-Checkliste in agents.md Punkt für Punkt durch und nenne mir jedes Ergebnis.

Ich bin kein Programmierer: Sag mir bei jedem Schritt, was du geändert hast und was ich tun muss.
```

## Erzählen Sie uns von Ihrer Website.

Unsicher? Wählen Sie „Anderes / unsicher“, dann sieht sich die KI zuerst Ihr Projekt an.

- Womit Ihre Website gebaut ist: WordPress / WooCommerce · PHP · Node.js / Next.js · Python · Go · Java · Anderes / unsicher
- Wie Sie bezahlt werden möchten:
  - Weiterleitung auf eine Zahlungsseite: Beim Checkout eine Rechnung erstellen; wir benachrichtigen Ihren Server, sobald bezahlt ist. Bestellungen werden von selbst versandt.
  - Eine feste Einzahlungsadresse pro Nutzer: Jeder Nutzer bekommt eine dauerhafte Adresse und lädt jederzeit einen beliebigen Betrag auf.
  - Zahlungslink (ohne Code): Link im Dashboard erstellen und teilen. Die KI fügt nur einen Button hinzu.

Zahlungslinks brauchen keinen Code: Dashboard → „Zahlungen › Zahlungslinks“ → Betrag eingeben → erstellen, dann den Link teilen. Die KI setzt nur einen Button auf Ihre Website.

## Welche KI nutzen Sie?

- **Claude Code / Codex**: KI, die Ihren Code bearbeitet und Befehle ausführt. Am einfachsten.
  - Öffnen Sie ein Terminal im Projektordner Ihrer Website und speichern Sie die Integrationsregeln als AGENTS.md:
  - `curl -fsSL https://blockwallets.io/agents.md -o AGENTS.md`
  - Codex liest AGENTS.md von selbst. Führen Sie für Claude Code zusätzlich aus:
  - `echo '@AGENTS.md' >> CLAUDE.md`
  - Fügen Sie dann den Prompt aus Schritt 3 ein.
  - Sie können auch den blockwallets-MCP-Server installieren, damit die KI die Dokumentation durchsuchen und Testrechnungen direkt erstellen kann. https://blockwallets.io/docs/mcp?lang=de
- **Cursor / Windsurf / Copilot**: KI in Ihrem Code-Editor.
  - Legen Sie AGENTS.md ebenfalls in den Projektstamm (Cursor erkennt sie automatisch):
  - `curl -fsSL https://blockwallets.io/agents.md -o AGENTS.md`
  - Wechseln Sie in den Agent-Modus und fügen Sie den Prompt ein.
  - Sie können auch den blockwallets-MCP-Server installieren, damit die KI die Dokumentation durchsuchen und Testrechnungen direkt erstellen kann. https://blockwallets.io/docs/mcp?lang=de
- **ChatGPT / Claude (Web)**: Nur Chat. Den Code fügen Sie selbst in Ihre Website ein.
  - Fügen Sie den Prompt in einen neuen Chat ein oder nutzen Sie unten „In ChatGPT / Claude öffnen“.
  - Sagt die KI, sie könne keine Links öffnen, öffnen Sie https://blockwallets.io/llms-full.txt, markieren Sie alles, kopieren Sie es und fügen Sie es ebenfalls ein.
  - Sie liefert vollständigen Code und sagt, wohin er gehört; folgen Sie ihr Schritt für Schritt. Ein Tool, das den Code für Sie bearbeitet (Claude Code, Codex, Cursor), erspart viel Kopieren.
- **Andere KI**: Gemini, Copilot-Chat und andere.
  - Fügen Sie den Prompt ein. Kann die KI keine Webseiten öffnen, fügen Sie zusätzlich den Inhalt von llms-full.txt ein.

## Kopieren Sie den Prompt.

Er passt sich Ihrer Auswahl oben an und enthält die Dokumentationslinks, die üblichen Fallstricke und eine Abnahme-Checkliste.

Beispiel: Anderes / unsicher + Weiterleitung auf eine Zahlungsseite + Claude Code / Codex

```text
Du bist mein Entwickler. Hilf mir, auf meiner Website Krypto-Zahlungen mit blockwallets anzunehmen (Kunden zahlen in USDT, USDC, BTC und 14 weiteren Coins; mir wird in US-Dollar gutgeschrieben).

## Über mich
- Meine Website ist gebaut mit: Ich bin nicht sicher. Sieh dir zuerst mein Projekt an, sag mir, womit es gebaut ist, und fang dann an.
- So möchte ich bezahlt werden: Erstelle beim Checkout eine Rechnung und leite den Kunden auf die blockwallets-Zahlungsseite weiter; wenn das Geld ankommt, ruft blockwallets meinen Server auf, und ich markiere die Bestellung als bezahlt und versende sie.
- Ich bin kein Programmierer. Sag mir bei jedem Schritt, welche Dateien du geändert hast und was ich tun muss (zum Beispiel wohin die Umgebungsvariablen gehören). Ändere nicht zu viel auf einmal.
- AGENTS.md im Projektstamm enthält die blockwallets-Integrationsregeln; lies sie zuerst und lies https://blockwallets.io/llms-full.txt für Details.

## Lies zuerst die Dokumentation; rate die API nicht aus dem Gedächtnis
- Vollständige Integrationsdokumentation (Markdown): https://blockwallets.io/llms-full.txt
- Integrationsregeln und häufige Fehler: https://blockwallets.io/agents.md
- Wenn die Seite schon Cryptomus, NOWPayments oder Coinbase Commerce nutzt, stelle sie auf die passende kompatible API um, statt sie neu zu schreiben: https://blockwallets.io/docs/migrate.md?lang=en
- Wenn du einen Link nicht öffnen kannst, sag es mir, dann füge ich den Inhalt ein.

## Kernpunkte (hier gehen Integrationen meist schief)
1. Jeder Endpoint ist POST + JSON auf https://blockwallets.io. Header: merchant = die merchant-UUID, sign = md5(base64(Request-Body) + API key). Signiere genau den JSON-String, den du sendest; serialisiere nach dem Signieren nicht neu.
2. Erstelle eine Rechnung mit POST /v1/payment. Pflicht: amount (ein String mit bis zu zwei Nachkommastellen, z. B. "42.00"), currency ("USD"), order_id (meine Bestellnummer: Buchstaben, Ziffern, - und _, bis zu 100 Zeichen). Übergib außerdem url_callback (die Webhook-URL) und url_success (wohin der Kunde nach der Zahlung zurückkehrt). Leite den Kunden auf result.url weiter.
3. Ein erneuter Aufruf mit derselben order_id liefert dieselbe Rechnung, Wiederholungen sind also sicher und erzeugen nie eine zweite Rechnung.
4. Webhook-Signaturen müssen geprüft werden: Parse das Webhook-JSON, entferne das Feld sign, kodiere den Rest so neu wie PHP json_encode (kompakt, Nicht-ASCII bleibt erhalten, / als \/ escaped), dann muss md5(base64(encoded) + API key) gleich sign sein. Das Escapen von / zu vergessen ist der häufigste Fehler.
5. Markiere die Bestellung nur als bezahlt, wenn status paid oder paid_over ist, und nutze payment_amount_usd. Derselbe Webhook kann mehrfach eintreffen: Dedupliziere über uuid + status. Antworte mit einem 2xx-Status, sobald er verarbeitet ist.
6. Lege die merchant-ID und den API key in Umgebungsvariablen ab (z. B. BW_MERCHANT, BW_API_KEY); schreibe sie nie fest in den Code und committe sie nicht. Trage die Domain der Webhook-URL zuerst im Dashboard unter „Entwickler › Integration & Keys“ bei „Website-Domains“ ein.
7. Bring zuerst alles mit den Test-Zugangsdaten zum Laufen (Testnets, kein echtes Geld); wechsle erst auf Live, nachdem ich es bestätigt habe.

## Wenn du fertig bist, prüfe jeden Punkt und nenne mir das Ergebnis
- [ ] Mit den Test-Zugangsdaten eine Testrechnung erstellen und den Link zur Zahlungsseite (result.url) erhalten
- [ ] Die Zahlungsseite öffnen und auf „Zahlung simulieren“ → voller Betrag klicken
- [ ] Mein Server erhält einen Webhook mit status paid, und die Signatur wird bestätigt
- [ ] Die zugehörige Bestellung ist als bezahlt markiert
- [ ] Derselbe erneut eintreffende Webhook (im Dashboard unter „Entwickler › Webhook-Protokoll“ oder per POST /v1/payment/resend erneut senden) versendet nicht doppelt

Schlägt ein Punkt fehl, sag mir, wo es hakt und wie die genaue Fehlermeldung lautet, bevor du etwas anderes änderst.
```

### Wenn die KI fertig ist, prüfen Sie Folgendes

**Weiterleitung auf eine Zahlungsseite**

1. Mit den Test-Zugangsdaten eine Testrechnung erstellen und den Link zur Zahlungsseite (result.url) erhalten
2. Die Zahlungsseite öffnen und auf „Zahlung simulieren“ → voller Betrag klicken
3. Mein Server erhält einen Webhook mit status paid, und die Signatur wird bestätigt
4. Die zugehörige Bestellung ist als bezahlt markiert
5. Derselbe erneut eintreffende Webhook (im Dashboard unter „Entwickler › Webhook-Protokoll“ oder per POST /v1/payment/resend erneut senden) versendet nicht doppelt

**Eine feste Einzahlungsadresse pro Nutzer**

1. Mit den Test-Zugangsdaten eine Adresse für einen Testnutzer öffnen und Adresse sowie Link zur Einzahlungsseite erhalten
2. Einen Beispiel-Webhook per POST /v1/test-webhook/wallet senden
3. Mein Server erhält einen Webhook mit type wallet, und die Signatur wird bestätigt
4. Das Guthaben dieses Nutzers steigt um payment_amount_usd
5. Derselbe erneut eintreffende Webhook schreibt das Guthaben nicht doppelt gut

**Zahlungslink (ohne Code)**

1. Der Button sieht auf dem Desktop und auf dem Smartphone richtig aus
2. Der Button öffnet meinen Zahlungslink (nutzen Sie zuerst einen im Testmodus erstellten Link)
3. Klickt man auf der Zahlungsseite auf „Zahlung simulieren“, erscheint die Zahlung im Dashboard unter „Zahlungen › Zahlungseingänge“

## Wenn die KI nicht weiterkommt.

- **Die Signatur wird nie bestätigt**: Fügen Sie den rohen Webhook-Body in den [Signaturprüfer](https://blockwallets.io/docs/sign?lang=de) ein. Er zeigt jeden Zwischenschritt und markiert die erste Abweichung; sagen Sie Ihrer KI genau, was abweicht.
- **Ein Endpoint liefert einen Fehler**: Fügen Sie die genaue Anfrage und Antwort (einschließlich message) wieder in Ihre KI ein. Bei falscher Signatur ist debug.body_base64 in der 401-Antwort der Text, den wir signiert haben; lassen Sie die KI ihn mit ihrem eigenen vergleichen.
- **Unklar, wo es hakt**: Bitten Sie die KI, die Abnahme-Checkliste ab dem ersten Punkt einzeln durchzugehen und jedes Ergebnis zu melden. Die Seite „Entwickler › Webhook-Protokoll“ im Dashboard zeigt jede Webhook-Anfrage und die Antwort Ihres Servers.

### Vier Dinge, auf die Sie achten.

- **Geben Sie der KI nur Test-Zugangsdaten**: Der Test-merchant und API key laufen auf Testnets; selbst wenn sie durchsickern, kann kein Geld bewegt werden.
- **Halten Sie den Live-API-key aus Chats heraus**: Legen Sie den Live-API-key selbst in die Umgebungsvariablen Ihres Servers. Fügen Sie ihn nie in einen Chat ein und committen Sie ihn nicht in ein Repository.
- **Sichern Sie vor den Änderungen der KI**: Committen Sie (git commit) oder kopieren Sie die Dateien Ihrer Website, bevor die KI beginnt, damit Sie zurückrollen können.
- **Zahlen Sie vor dem Livegang selbst einmal**: Zahlen Sie nach dem Wechsel auf Live über „Zahlung ausprobieren“ auf der Startseite des Dashboards einen kleinen echten Betrag und prüfen Sie, dass die Bestellung bezahlt ist und das Guthaben ankommt.

## Eine Regeldatei für Coding-Agenten.

AGENTS.md enthält das Wesentliche der Integration, häufige Fehler und die Abnahme-Checkliste. Legen Sie sie in Ihren Projektstamm: Codex und Cursor lesen sie automatisch, Claude Code importiert sie mit @AGENTS.md.

```sh
curl -fsSL https://blockwallets.io/agents.md -o AGENTS.md
echo '@AGENTS.md' >> CLAUDE.md
```

- [Integrationsregeln (AGENTS.md)](https://blockwallets.io/agents.md)
- [Zusammenfassung auf einer Seite](https://blockwallets.io/llms.txt)
- [Vollständige Dokumentation](https://blockwallets.io/llms-full.txt)
- [Diese Seite als Markdown](https://blockwallets.io/docs/ai.md?lang=de)
- [Dokumentation als Markdown](https://blockwallets.io/docs.md?lang=de)
- [MCP-Server](https://blockwallets.io/docs/mcp?lang=de)

## Fragen, beantwortet.

### Kann ich wirklich mit KI integrieren, wenn ich nicht programmieren kann?

Für die meisten Websites ja. Die KI schreibt den Code zum Erstellen von Rechnungen und für die Signatur anhand der Dokumentation; Sie legen die Zugangsdaten in Umgebungsvariablen ab und gehen im Testmodus die Abnahme-Checkliste durch. Wenn Sie gar keinen Code möchten, nutzen Sie Zahlungslinks.

### Welches KI-Tool sollte ich nutzen?

Am einfachsten ist ein Tool, das Ihr Projekt bearbeitet und Befehle ausführt: Claude Code, Codex oder Cursor. ChatGPT oder Claude im Web funktionieren auch, aber den Code fügen Sie selbst in Ihre Website ein.

### Soll ich der KI meinen API key geben?

Nur die Test-Zugangsdaten, und in einer Umgebungsdatei statt im Chat. Legen Sie den Live-API-key selbst auf Ihrem Server ab.

### Die Webhook-Signatur wird nie bestätigt. Was nun?

Entfernen Sie sign, kodieren Sie den Rest so neu wie PHP json_encode und escapen Sie / als \/. Fügen Sie den rohen Webhook-Body in /docs/sign ein, um jeden Schritt zu vergleichen, und sagen Sie der KI, was abweicht.

### Die KI sagt, sie sei fertig. Wie prüfe ich das?

Gehen Sie die Abnahme-Checkliste durch: eine Testrechnung erstellen, die Zahlung simulieren, sehen, dass der Webhook bestätigt wird, sehen, dass die Bestellung als bezahlt markiert ist, und denselben Webhook erneut senden, um zu bestätigen, dass nichts doppelt versandt wird. Zahlen Sie vor dem Livegang einen kleinen Live-Betrag.