Frisbii Developer Toolkit : skills pour les assistants de codage IA

Aperçu

Le Frisbii Developer Toolkit apporte aux assistants de codage IA, tels que Claude Code, Cursor et Codex, une expertise sur Frisbii Billing et Frisbii Pay. Vos développeurs continuent de travailler dans leur propre éditeur et demandent de l'aide à leur assistant en langage naturel. L'assistant utilise les skills du toolkit pour écrire du code d'intégration qui suit les modèles recommandés par Frisbii et évite les erreurs que nous constatons le plus souvent au support.

Un skill est un ensemble d'instructions, de documentation de référence et de petits scripts consacrés à un sujet précis, comme le checkout ou les webhooks. Vos développeurs n'ont pas besoin de nommer un skill : l'assistant choisit automatiquement le bon en fonction de leur demande.

Avant de commencer

• Vos développeurs utilisent un assistant de codage IA compatible avec les skills, comme Claude Code, Cursor ou Codex.

• Vous disposez d'un compte de test Frisbii pour développer et tester. N'utilisez jamais de clés live pendant le développement. Si vous n'avez pas encore de compte de test, vous pouvez en créer un ici : https://frisbii.com/signup/

Installer le toolkit

Claude Code : exécutez ces deux commandes dans Claude Code :

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

Cela installe les six skills et connecte également le serveur MCP Frisbii, afin que l'assistant puisse consulter et créer des données dans votre compte de test pendant qu'il code. Les skills fonctionnent aussi sans connexion MCP. Consultez Connecter MCP à votre assistant IA pour savoir comment la connexion s'authentifie avec votre clé API.

Remarque

L'utilisation de MCP est facturée au token.

Cursor, Codex et autres assistants : exécutez cette commande dans le dossier de votre projet et choisissez les skills souhaités :

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

Les autres assistants reçoivent uniquement les skills. Pour utiliser également le serveur MCP, ajoutez https://mcp.frisbii.com/mcp dans les paramètres MCP de l'assistant concerné.

Les skills

Pour chaque skill ci-dessous, vous trouverez son objectif ainsi que des exemples de prompts que vos développeurs peuvent utiliser. Ces prompts ne sont que des exemples : toute demande portant sur le même sujet fera appel au skill.

Frisbii best practices

Objectif : le point de départ de toute intégration Frisbii. Il aide l'assistant à choisir le produit et l'API Frisbii adaptés à ce que vous souhaitez créer, et applique les fondamentaux dont toute intégration a besoin : authentification, comptes de test et live, handles, nouvelles tentatives sécurisées sans double débit, gestion des erreurs et liste des erreurs d'intégration que nous constatons le plus souvent au support. Si nécessaire, il passe le relais aux skills plus spécifiques présentés ci-dessous.

Exemples de prompts :

• « Nous souhaitons vendre des adhésions mensuelles sur notre site web. Quels produits et quelles API Frisbii devons-nous utiliser, et comment structurer l'intégration ? »

• « Configurez un client API Frisbii pour notre backend Node.js avec authentification, délais d'expiration et gestion des erreurs. »

• « Comment m'assurer qu'une nouvelle tentative après l'échec d'une requête ne débite jamais un client deux fois ? »

• « Vérifiez notre code Frisbii au regard des erreurs d'intégration courantes et indiquez-moi ce qu'il faut corriger. »

Frisbii checkout

Objectif : mettre en place l'encaissement des paiements avec Frisbii Checkout : paiements ponctuels, enregistrement d'une carte ou d'un wallet pour de futurs paiements, et checkout pour la souscription d'abonnements. Il couvre le choix entre checkout hébergé, intégré et modal, les moyens de paiement à proposer sur chaque marché (cartes, MobilePay, Vipps, Swish, SEPA, Apple Pay, Google Pay, Klarna, PayPal et autres), 3-D Secure et SCA, la confirmation sécurisée des paiements sur votre serveur, ainsi que la capture et le remboursement.

Exemples de prompts :

• « Ajoutez un Frisbii Checkout à notre page de commande pour que les clients puissent payer par carte, MobilePay ou Apple Pay. »

• « Nous vendons des biens physiques. Réservez le paiement lors du checkout et ne le débitez qu'à l'expédition de la commande. »

• « Quels moyens de paiement devons-nous proposer aux clients au Danemark, en Norvège, en Suède et en Allemagne ? »

• « Apple Pay ne s'affiche pas dans notre checkout intégré. Que nous manque-t-il ? »

• « Enregistrez la carte du client lors de l'inscription afin que nous puissions la débiter pour de futures commandes. »

Frisbii subscriptions

Objectif : mettre en place la facturation récurrente avec Frisbii Billing. Il couvre la conception des plans et des tarifs, la création et la modification d'abonnements, les add-ons, remises et coupons, les périodes d'essai, les upgrades et downgrades avec calcul au prorata, la facturation à l'usage, les durées de contrat et délais de préavis, la mise en pause et la résiliation, le portail client, ainsi que la gestion des renouvellements échoués et des relances.

Exemples de prompts :

• « Créez les plans Basic, Pro et Enterprise avec facturation mensuelle et annuelle et une période d'essai gratuite de 14 jours. »

• « Permettez aux clients de passer de Basic à Pro en milieu de mois en ne payant que la différence. »

• « Nous facturons par appel API. Mettez en place la facturation à l'usage et transmettez l'utilisation depuis notre application chaque jour. »

• « Que doit faire notre application lorsqu'un paiement de renouvellement échoue, et quand devons-nous couper l'accès ? »

• « Ajoutez un lien vers le portail client Frisbii pour que les clients puissent mettre à jour leur carte ou résilier leur abonnement. »

Frisbii webhooks

Objectif : recevoir les webhooks Frisbii de manière fiable et sécurisée. Il couvre la vérification de la signature de chaque webhook (avec du code prêt à l'emploi pour Python, Node.js, PHP, Java, C# et Go), le choix des événements à traiter, la rapidité de réponse, la gestion des nouvelles tentatives, des doublons et des événements qui arrivent dans le désordre, ainsi que le test des webhooks en local.

Exemples de prompts :

• « Créez un endpoint de webhook dans notre application Express qui vérifie les signatures Frisbii et marque les commandes comme payées. »

• « De quels événements webhook Frisbii avons-nous besoin pour une activité par abonnement ? »

• « Notre gestionnaire de webhooks traite parfois le même événement deux fois. Faites en sorte qu'il puisse être exécuté plusieurs fois sans risque. »

• « Envoyez un webhook de test à mon serveur local pour que je puisse vérifier que la vérification de signature fonctionne. »

Frisbii migrate from Stripe

Objectif : migrer une intégration Stripe existante et ses données de facturation vers Frisbii. Il fait correspondre les objets et les événements webhook Stripe à leurs équivalents Frisbii, guide les modifications du code et planifie le volet données : export des cartes depuis Stripe, import des clients SEPA et PayPal, et utilisation de Stripe et Frisbii en parallèle pendant la transition.

Exemples de prompts :

• « Nous utilisons actuellement Stripe Checkout et Stripe Subscriptions. Planifiez notre migration vers Frisbii. »

• « Remplacez notre code Stripe PaymentIntent par son équivalent Frisbii. »

• « Faites correspondre nos gestionnaires de webhooks Stripe aux événements Frisbii. »

• « Comment transférer les cartes enregistrées de nos clients de Stripe vers Frisbii sans leur demander de les ressaisir ? »

Frisbii go-live review

Objectif : vérifier qu'une intégration est prête avant de passer de votre compte de test à votre compte live. L'assistant analyse votre code à la recherche de problèmes courants (comme des clés API écrites en dur dans le code ou des paiements confirmés uniquement via la redirection du navigateur), parcourt une checklist portant sur les clés, les paiements, les webhooks, les abonnements, la gestion des erreurs et les preuves de test, puis vous donne un verdict (prêt, prêt après corrections ou pas prêt) en indiquant le fichier et la ligne concernés pour chaque constat. Il présente d'abord son rapport et ne modifie le code que si vous le lui demandez.

Exemples de prompts :

• « Notre intégration Frisbii est-elle prête pour la mise en production ? »

• « Effectuez une revue de sécurité de notre code de paiement avant le lancement. »

• « Nous passons du compte de test Frisbii au compte live la semaine prochaine. Que devons-nous vérifier ? »

Conseils pour obtenir les meilleurs résultats

• Indiquez ce que vous développez et dans quel langage ou framework, par exemple « une boutique Django qui vend des biens physiques au Danemark ».

• Développez avec votre compte de test. Conservez les clés API dans la configuration ou dans un gestionnaire de secrets, jamais dans le code que vous partagez avec l'assistant.

• Effectuez la go-live review avant le lancement, même si vous avez créé l'intégration sans le toolkit.

• La référence de l'API Frisbii fait foi. Les skills renvoient votre assistant vers docs.frisbii.com pour tous les détails.