Billing SDK

​

Visão Geral

• Componentes React: Componentes de cobrança pré-construídos e personalizáveis para aplicações React
• Ferramentas de CLI: Interface de linha de comando para inicialização de projetos e gerenciamento de componentes
• Suporte a Frameworks: Integração com Next.js, Express.js, Hono, Fastify e React
• Provedor de Pagamento: Integração completa com Dodo Payments

​

Começo Rápido

npx @billingsdk/cli --help

npm install -g @billingsdk/cli

npx @billingsdk/cli init

npx @billingsdk/cli add pricing-table-one
npx @billingsdk/cli add subscription-management

​

Frameworks Suportados

​

Comandos da CLI

​

@billingsdk/cli init

1. Seleção de Framework: Escolha seu framework preferido
2. Instalação de Template: Baixa e instala templates específicos do framework com integração ao Dodo Payments
3. Gerenciamento de Dependências: Instala automaticamente as dependências necessárias
4. Geração de Arquivos: Cria arquivos de configuração necessários e código boilerplate

npx @billingsdk/cli init

​

@billingsdk/cli add

# Add a pricing table
npx @billingsdk/cli add pricing-table-one

# Add subscription management
npx @billingsdk/cli add subscription-management

# Add usage monitoring
npx @billingsdk/cli add usage-meter-circle

1. Faz o download da configuração do componente do registro
2. Instala os arquivos do componente no seu components/billingsdk/ diretório
3. Atualiza a configuração do seu projeto se necessário
4. Instala quaisquer dependências adicionais

​

Estrutura de Arquivos Gerados

• Rotas da API: Endpoints abrangentes para checkout, clientes, produtos, assinaturas e webhooks
• Hooks: Hooks React para operações de cobrança (se estiver usando React/Next.js)
• Arquivos de Biblioteca: Inicialização do cliente do provedor de pagamento e utilitários
• Configuração de Ambiente: Arquivos de variáveis de ambiente de exemplo

​

Estrutura de Exemplo do Next.js

your-project/
├── app/api/
│   └── (dodopayments)/
│       ├── checkout/route.ts
│       ├── customer/route.ts
│       ├── customer/payments/route.ts
│       ├── customer/subscriptions/route.ts
│       ├── product/route.ts
│       ├── products/route.ts
│       └── webhook/route.ts
├── hooks/
│   └── useBilling.ts
├── lib/
│   └── dodopayments.ts
└── .env.example

​

Configuração de Ambiente

# DodoPayments
DODO_PAYMENTS_API_KEY=your_api_key_here
DODO_PAYMENTS_ENVIRONMENT=test_mode
DODO_PAYMENTS_WEBHOOK_KEY=your_webhook_key_here

# App URL
NEXT_PUBLIC_APP_URL=http://localhost:3000

​

Componentes Disponíveis

• Tabelas de Preços: Múltiplas variantes para exibir preços de produtos
• Gerenciamento de Assinaturas: Componentes para gerenciar assinaturas de clientes
• Monitoramento de Uso: Componentes visuais para rastrear cobrança baseada em uso
• Componentes de Checkout: Fluxos de checkout pré-construídos
• Portal do Cliente: Componentes para autoatendimento do cliente

​

Código Aberto

• 🔍 Transparência: Total visibilidade sobre como os componentes funcionam
• 🤝 Comunidade: Construído por desenvolvedores, para desenvolvedores
• 🔒 Segurança: Código aberto significa melhor segurança através de revisão por pares
• 📈 Inovação: Iteração mais rápida através de contribuições da comunidade

​

Obtendo Ajuda

• Problemas no GitHub: Abra um problema
• Documentação: Visite billingsdk.com/docs
• Documentação Completa de LLMs: billingsdk.com/llms-full.txt

​

Contribuindo

• Relatar bugs
• Solicitar recursos
• Enviar pull requests
• Adicionar novos componentes
• Melhorar a documentação

​

Saiba Mais