Passer au contenu principal
Le SDK de Facturation est une solution open-source complète qui fournit une infrastructure de facturation intégrale pour les applications web modernes. Il comprend des composants React, des outils CLI et un support d’intégration full-stack pour plusieurs frameworks avec Dodo Payments.

Aperçu

Le SDK de Facturation offre :
  • Composants React : Composants de facturation préconstruits et personnalisables pour les applications React
  • Outils CLI : Interface en ligne de commande pour l’initialisation de projet et la gestion des composants
  • Support de Framework : Intégration avec Next.js, Express.js, Hono, Fastify et React
  • Fournisseur de Paiement : Intégration complète avec Dodo Payments

Démarrage Rapide

Commencez avec le SDK de Facturation en quelques minutes :
1

Install the CLI

Utilisez npx pour exécuter l’interface en ligne de commande sans installation :
Ou installez-le globalement pour une utilisation fréquente :
2

Initialize a Project

Lancez la configuration interactive pour créer un nouveau projet de facturation :
Vous serez invité à sélectionner :
  • Votre framework préféré (Next.js, Express.js, Hono, Fastify, React)
  • Votre fournisseur de paiement (Dodo Payments)
3

Add Components

Ajoutez des composants de facturation individuels à votre projet :

Frameworks Supportés

Le SDK de Facturation prend en charge plusieurs frameworks avec une intégration complète de Dodo Payments :

Commandes CLI

@billingsdk/cli init

Initialisez un nouveau projet de facturation avec une configuration complète incluant la configuration du framework, l’intégration de Dodo Payments et les dépendances essentielles. Ce que cela fait :
  1. Sélection de Framework : Choisissez votre framework préféré
  2. Installation de Modèle : Télécharge et installe les modèles spécifiques au framework avec l’intégration de Dodo Payments
  3. Gestion des Dépendances : Installe automatiquement les dépendances requises
  4. Génération de Fichiers : Crée les fichiers de configuration nécessaires et le code de base
Exemple :

@billingsdk/cli add

Ajoutez des composants de facturation individuels à votre projet existant en utilisant le système de registre shadcn/ui. Exemples :
Ce qui se passe :
  1. Télécharge la configuration du composant depuis le registre
  2. Installe les fichiers du composant dans votre components/billingsdk/ répertoire
  3. Met à jour la configuration de votre projet si nécessaire
  4. Installe les dépendances supplémentaires

Structure des Fichiers Générés

Après avoir exécuté init, vous obtiendrez une structure de projet complète avec :
  • Routes API : Points de terminaison complets pour le paiement, les clients, les produits, les abonnements et les webhooks
  • Hooks : Hooks React pour les opérations de facturation (si vous utilisez React/Next.js)
  • Fichiers de Bibliothèque : Initialisation du client du fournisseur de paiement et utilitaires
  • Configuration de l’Environnement : Fichiers d’exemple de variables d’environnement

Exemple de Structure Next.js

Configuration de l’Environnement

Configurez vos variables d’environnement après l’initialisation :
Stockez toujours vos clés API de manière sécurisée en utilisant des variables d’environnement. Ne les validez jamais dans un système de contrôle de version.

Composants Disponibles

Le SDK de Facturation fournit une collection complète de composants React :
  • Tables de Tarification : Plusieurs variantes pour afficher les prix des produits
  • Gestion des Abonnements : Composants pour gérer les abonnements des clients
  • Suivi de l’Utilisation : Composants visuels pour suivre la facturation basée sur l’utilisation
  • Composants de Paiement : Flux de paiement préconstruits
  • Portail Client : Composants pour l’auto-service des clients

Open Source

Le SDK de Facturation est construit sur des principes open-source :
  • 🔍 Transparence : Visibilité complète sur le fonctionnement des composants
  • 🤝 Communauté : Construit par des développeurs, pour des développeurs
  • 🔒 Sécurité : Code ouvert signifie meilleure sécurité grâce à la révision par les pairs
  • 📈 Innovation : Itération plus rapide grâce aux contributions de la communauté
Le SDK de facturation est publié sous la licence publique générale GNU (GPL), garantissant que le projet reste ouvert et gratuit.

Obtenir de l’Aide

Besoin d’assistance avec le SDK de Facturation ?

Contribuer

Nous accueillons les contributions ! Consultez notre guide de contribution pour plus de détails sur :
  • Signaler des bogues
  • Demander des fonctionnalités
  • Soumettre des demandes de tirage
  • Ajouter de nouveaux composants
  • Améliorer la documentation

En Savoir Plus

Full Documentation

Guide complet du SDK de facturation avec exemples et meilleures pratiques

CLI Reference

Documentation CLI détaillée pour toutes les commandes et options

Component Library

Parcourez tous les composants disponibles avec des exemples interactifs
Dernière modification le 1 avril 2026