Frisbii Developer Toolkit: Skills für KI-Coding-Assistenten

Überblick

Das Frisbii Developer Toolkit gibt KI-Coding-Assistenten wie Claude Code, Cursor und Codex Expertenwissen zu Frisbii Billing und Frisbii Pay. Dein Entwicklungsteam arbeitet weiter im gewohnten Editor und bittet den Assistenten in natürlicher Sprache um Hilfe. Der Assistent nutzt die Skills des Toolkits, um Integrationscode zu schreiben, der den von Frisbii empfohlenen Mustern folgt und die Fehler vermeidet, die wir im Support am häufigsten sehen.

Ein Skill ist ein Paket aus Anweisungen, Referenzmaterial und kleinen Skripten zu einem bestimmten Thema, z. B. Checkout oder Webhooks. Dein Entwicklungsteam muss keinen Skill benennen: Der Assistent wählt anhand der Anfrage automatisch den passenden aus.

Bevor du beginnst

• Dein Entwicklungsteam nutzt einen KI-Coding-Assistenten, der Skills unterstützt, z. B. Claude Code, Cursor oder Codex.

• Du hast ein Frisbii-Testkonto, mit dem du entwickeln und testen kannst. Verwende während der Entwicklung niemals Live-Schlüssel. Wenn du noch kein Testkonto hast, kannst du hier eins erstellen: https://frisbii.com/signup/

Toolkit installieren

Claude Code: Führe diese beiden Befehle in Claude Code aus:

/plugin marketplace add frisbii-com/frisbii-developer-toolkit
/plugin install frisbii@frisbii-developer-toolkit

Damit werden alle sechs Skills installiert und zusätzlich der Frisbii MCP-Server verbunden. So kann der Assistent beim Programmieren Daten in deinem Testkonto abrufen und anlegen. Die Skills funktionieren auch ohne MCP-Verbindung. Unter MCP mit deinem KI-Assistenten verbinden erfährst du, wie sich die Verbindung mit deinem API-Schlüssel anmeldet.

Hinweis

Die MCP-Nutzung wird pro Token abgerechnet.

Cursor, Codex und andere Assistenten: Führe diesen Befehl in deinem Projektordner aus und wähle die gewünschten Skills aus:

npx skills add frisbii-com/frisbii-developer-toolkit

Andere Assistenten erhalten nur die Skills. Um zusätzlich den MCP-Server zu nutzen, füge https://mcp.frisbii.com/mcp in den MCP-Einstellungen des jeweiligen Assistenten hinzu.

Die Skills

Zu jedem Skill findest du unten den Zweck und Beispiel-Prompts, die dein Entwicklungsteam verwenden kann. Die Prompts sind nur Beispiele: Jede Anfrage zum gleichen Thema nutzt den Skill.

Frisbii best practices

Zweck: der Ausgangspunkt für jede Frisbii-Integration. Der Skill hilft dem Assistenten, das passende Frisbii-Produkt und die passende API für dein Vorhaben auszuwählen. Außerdem wendet er die Grundlagen an, die jede Integration braucht: Authentifizierung, Test- und Live-Konten, Handles, sichere Wiederholungsversuche ohne Doppelbelastungen, Fehlerbehandlung und eine Liste der Integrationsfehler, die wir im Support am häufigsten sehen. Bei Bedarf übergibt er an die spezifischeren Skills weiter unten.

Beispiel-Prompts:

• „Wir möchten auf unserer Website Monatsmitgliedschaften verkaufen. Welche Frisbii-Produkte und -APIs sollten wir nutzen und wie sollten wir die Integration aufbauen?“

• „Richte einen Frisbii-API-Client für unser Node.js-Backend mit Authentifizierung, Timeouts und Fehlerbehandlung ein.“

• „Wie stelle ich sicher, dass ein Wiederholungsversuch nach einer fehlgeschlagenen Anfrage einen Kunden niemals doppelt belastet?“

• „Prüfe unseren Frisbii-Code auf die häufigsten Integrationsfehler und sag mir, was ich beheben muss.“

Frisbii checkout

Zweck: Zahlungsabwicklung mit Frisbii Checkout aufbauen: Einmalzahlungen, Speichern einer Karte oder Wallet für künftige Zahlungen und Checkout für Abo-Anmeldungen. Der Skill deckt die Wahl zwischen gehostetem, eingebettetem und modalem Checkout ab, die passenden Zahlungsmethoden für jeden Markt (Karten, MobilePay, Vipps, Swish, SEPA, Apple Pay, Google Pay, Klarna, PayPal und weitere), 3-D Secure und SCA, die sichere Bestätigung von Zahlungen auf deinem Server sowie das Abbuchen (Settle) und Erstatten.

Beispiel-Prompts:

• „Füge unserer Bestellseite einen Frisbii Checkout hinzu, damit Kunden per Karte, MobilePay oder Apple Pay bezahlen können.“

• „Wir verkaufen physische Waren. Reserviere die Zahlung beim Checkout und buche sie erst ab, wenn die Bestellung versendet wird.“

• „Welche Zahlungsmethoden sollten wir Kunden in Dänemark, Norwegen, Schweden und Deutschland anbieten?“

• „Apple Pay wird in unserem eingebetteten Checkout nicht angezeigt. Was fehlt?“

• „Speichere die Karte des Kunden bei der Registrierung, damit wir sie für künftige Bestellungen belasten können.“

Frisbii subscriptions

Zweck: wiederkehrende Abrechnung mit Frisbii Billing aufbauen. Der Skill deckt die Gestaltung von Plänen und Preisen ab, das Anlegen und Ändern von Abonnements, Add-ons, Rabatte und Coupons, Testphasen, Up- und Downgrades mit anteiliger Berechnung, nutzungsbasierte Abrechnung, Vertrags- und Kündigungsfristen, Pausieren und Kündigen, das Kundenportal sowie den Umgang mit fehlgeschlagenen Verlängerungen und das Mahnwesen.

Beispiel-Prompts:

• „Erstelle die Pläne Basic, Pro und Enterprise mit monatlicher und jährlicher Abrechnung und einer 14-tägigen kostenlosen Testphase.“

• „Ermögliche Kunden, mitten im Monat von Basic auf Pro zu wechseln und nur die Differenz zu zahlen.“

• „Wir rechnen pro API-Aufruf ab. Richte eine nutzungsbasierte Abrechnung ein und melde die Nutzung täglich aus unserer App.“

• „Was sollte unsere App tun, wenn eine Verlängerungszahlung fehlschlägt, und wann sollten wir den Zugang sperren?“

• „Füge einen Link zum Frisbii-Kundenportal hinzu, damit Kunden ihre Karte aktualisieren oder kündigen können.“

Frisbii webhooks

Zweck: Frisbii-Webhooks zuverlässig und sicher empfangen. Der Skill deckt die Verifizierung der Signatur jedes Webhooks ab (mit fertigem Code für Python, Node.js, PHP, Java, C# und Go), die Auswahl der zu verarbeitenden Events, schnelles Antworten, den Umgang mit Wiederholungen, Duplikaten und Events, die in falscher Reihenfolge ankommen, sowie das lokale Testen von Webhooks.

Beispiel-Prompts:

• „Baue in unserer Express-App einen Webhook-Endpunkt, der Frisbii-Signaturen verifiziert und Bestellungen als bezahlt markiert.“

• „Welche Frisbii-Webhook-Events brauchen wir für ein Abo-Geschäft?“

• „Unser Webhook-Handler verarbeitet manchmal dasselbe Event zweimal. Sorge dafür, dass er auch bei mehrfacher Ausführung sicher funktioniert.“

• „Sende einen Test-Webhook an meinen lokalen Server, damit ich prüfen kann, ob die Signaturverifizierung funktioniert.“

Frisbii migrate from Stripe

Zweck: eine bestehende Stripe-Integration samt Abrechnungsdaten zu Frisbii migrieren. Der Skill ordnet Stripe-Objekte und Webhook-Events ihren Frisbii-Entsprechungen zu, begleitet die Codeänderungen und plant die Datenmigration: Export der Karten aus Stripe, Import von SEPA- und PayPal-Kunden sowie Parallelbetrieb von Stripe und Frisbii während der Umstellung.

Beispiel-Prompts:

• „Wir nutzen derzeit Stripe Checkout und Stripe Subscriptions. Plane unsere Migration zu Frisbii.“

• „Ersetze unseren Stripe-PaymentIntent-Code durch das Frisbii-Äquivalent.“

• „Ordne unsere Stripe-Webhook-Handler den Frisbii-Events zu.“

• „Wie übertragen wir die gespeicherten Karten unserer Kunden von Stripe zu Frisbii, ohne dass sie diese erneut eingeben müssen?“

Frisbii go-live review

Zweck: prüfen, ob eine Integration bereit ist, bevor du von deinem Testkonto auf dein Live-Konto umstellst. Der Assistent durchsucht deinen Code nach häufigen Problemen (z. B. direkt im Code hinterlegte API-Schlüssel oder Zahlungen, die nur über die Browser-Weiterleitung bestätigt werden). Anschließend arbeitet er eine Checkliste zu Schlüsseln, Zahlungen, Webhooks, Abonnements, Fehlerbehandlung und Testnachweisen ab und gibt dir ein Ergebnis (bereit, bereit nach Korrekturen oder nicht bereit) mit Datei und Zeile zu jedem Befund. Er erstellt zuerst einen Bericht und ändert Code nur, wenn du ihn darum bittest.

Beispiel-Prompts:

• „Ist unsere Frisbii-Integration bereit für den Go-live?“

• „Führe vor dem Launch eine Sicherheitsprüfung unseres Zahlungscodes durch.“

• „Wir stellen nächste Woche vom Frisbii-Testkonto auf das Live-Konto um. Was müssen wir prüfen?“

Tipps für die besten Ergebnisse

• Sag, was du baust und mit welcher Programmiersprache oder welchem Framework, z. B. „ein Django-Shop, der physische Waren in Dänemark verkauft“.

• Entwickle mit deinem Testkonto. Bewahre API-Schlüssel in der Konfiguration oder einem Secret Store auf, niemals im Code, den du mit dem Assistenten teilst.

• Führe vor dem Launch das Go-live-Review durch, auch wenn du die Integration ohne das Toolkit gebaut hast.

• Die Frisbii-API-Referenz bleibt die maßgebliche Quelle. Die Skills verweisen deinen Assistenten für alle Details auf docs.frisbii.com.