Visão Geral dos Adaptadores de Framework - Dodo Payments Documentation

Dodo Payments fornece adaptadores de framework oficiais que simplificam a integração de pagamentos. Cada adaptador é projetado para funcionar perfeitamente com as convenções do seu framework, oferecendo checkout, portal do cliente e manipulação de webhook prontos para uso.

Adaptadores de framework permitem integrar o Dodo Payments em menos de 10 linhas de código. Eles lidam automaticamente com autenticação, análise de requisições e formatação de respostas.

Adaptadores de Framework Disponíveis

Escolha o adaptador que corresponde ao seu framework:

Next.js

Suporte ao App Router com manipuladores de rota para checkout, portal e webhooks

Nuxt

Framework full-stack baseado em Vue com integração de rotas de servidor

Express

Manipuladores baseados em middleware para o popular framework Node.js

Fastify

Framework Node.js de alta performance com arquitetura de plugins

Hono

Framework web ultrarrápido para edge, Cloudflare Workers e mais

Astro

Framework com foco em conteúdo e suporte a endpoints de servidor

SvelteKit

Framework full-stack Svelte com integração de hooks de servidor

Remix

Framework full-stack React com manipuladores de loader e action

TanStack Start

Framework full-stack React type-safe com funções de servidor

Better Auth

Plugin de framework de autenticação para autenticação e pagamentos fluídos

Convex

Componente Backend-as-a-Service para sincronização de pagamentos em tempo real

Bun

Manipuladores nativos Bun.serve() para checkout, portal e webhooks

Recursos Principais

Todos os adaptadores de framework fornecem estas capacidades integradas:

Feature	Description
Checkout Handler	Suporte para fluxos de checkout estáticos, dinâmicos e baseados em sessão
Customer Portal	Manipulador pronto para gestão de assinaturas e faturamento
Webhook Handler	Verificação segura de assinatura com manipuladores de eventos tipados
Environment Config	Configuração simples via variáveis de ambiente
Type Safety	Suporte completo ao TypeScript com payloads tipados

Início Rápido

Comece com qualquer adaptador de framework em três etapas:

Install the Adaptor

Use o gerenciador de pacotes para instalar o adaptador específico do framework:

npm install @dodopayments/nextjs

npm install @dodopayments/nuxt

npm install @dodopayments/express

npm install @dodopayments/hono

npm install @dodopayments/astro

npm install @dodopayments/sveltekit

Configure Environment Variables

Adicione suas credenciais do Dodo Payments ao seu ambiente:

DODO_PAYMENTS_API_KEY=your-api-key
DODO_PAYMENTS_WEBHOOK_KEY=your-webhook-secret
DODO_PAYMENTS_RETURN_URL=https://yourdomain.com/checkout/success
DODO_PAYMENTS_ENVIRONMENT="test_mode" # or "live_mode"

Nunca faça commit do seu .env ou segredos no controle de versão.

Create Route Handlers

Configure suas rotas de checkout, portal do cliente e webhooks:

Next.js
Express
Hono

// app/checkout/route.ts
import { Checkout } from "@dodopayments/nextjs";

export const GET = Checkout({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
  environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
});

import { checkoutHandler } from '@dodopayments/express';

app.get('/api/checkout', checkoutHandler({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
  environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
}));

import { Checkout } from "@dodopayments/hono";

app.get('/checkout', Checkout({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
  environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
}));

Agora você está pronto para processar pagamentos! Visite as páginas individuais dos adaptadores para guias detalhados e todas as opções disponíveis.

Tipos de Fluxo de Checkout

Todos os adaptadores suportam três tipos de fluxo de checkout:

Static Checkout (GET)

Use checkout estático para links de pagamento simples e compartilháveis. Passe o ID do produto como parâmetro de consulta:

/api/checkout?productId=pdt_xxx&quantity=1

Suporta preenchimento e personalização opcionais do cliente por meio de parâmetros de consulta.

Dynamic Checkout (POST)

Use checkout dinâmico para criar pagamentos programaticamente com detalhes personalizados:

{
  "product_id": "pdt_xxx",
  "customer": {
    "email": "customer@example.com",
    "name": "John Doe"
  },
  "quantity": 1
}

Suporta pagamentos únicos e assinaturas.

Checkout Sessions (POST)

Use sessões de checkout para a experiência mais flexível com suporte a carrinho:

{
  "product_cart": [
    { "product_id": "pdt_xxx", "quantity": 1 },
    { "product_id": "pdt_yyy", "quantity": 2 }
  ],
  "customer": {
    "email": "customer@example.com"
  }
}

Saiba mais no Guia de Sessões de Checkout.

Manipulação de Eventos de Webhook

Todos os adaptadores proporcionam tratamento de webhooks com segurança de tipos e callbacks de eventos granulares:

Webhooks({
  webhookKey: process.env.DODO_PAYMENTS_WEBHOOK_KEY,
  onPayload: async (payload) => {
    // Handle any webhook event
  },
  onPaymentSucceeded: async (payload) => {
    // Handle successful payments
  },
  onSubscriptionActive: async (payload) => {
    // Handle new subscriptions
  },
  // ... 20+ event types supported
});

Todos os manipuladores de webhook verificam automaticamente assinaturas e validam payloads usando esquemas Zod. Requisições inválidas são rejeitadas com códigos de erro apropriados.

Escolhendo o Adaptador Certo

Framework	Best For	Runtime
Next.js	Aplicações React full-stack com App Router	Node.js, Edge
Nuxt	Aplicações Vue.js full-stack	Node.js
Express	APIs REST e apps Node.js tradicionais	Node.js
Fastify	APIs de alta performance	Node.js
Hono	Deployments em edge, Cloudflare Workers	Edge, Node.js
Astro	Sites de conteúdo com endpoints de servidor	Node.js, Edge
SvelteKit	Aplicações Svelte full-stack	Node.js
Remix	React full-stack com rotas aninhadas	Node.js
TanStack Start	React full-stack type-safe	Node.js
Better Auth	Apps que já usam Better Auth	Diversos
Convex	Apps que utilizam Convex no backend	Convex Runtime
Bun	Aplicações com servidor nativo Bun	Bun

Obter Ajuda

Precisa de assistência com adaptadores de framework?

Discord: Participe do nosso servidor comunitário para ajuda em tempo real
Email: Entre em contato pelo support@dodopayments.com
GitHub: Abra uma issue no repositório do adaptador correspondente
Documentação: Visite nossa referência de API

​Adaptadores de Framework Disponíveis

Next.js

Nuxt

Express

Fastify

Hono

Astro

SvelteKit

Remix

TanStack Start

Better Auth

Convex

Bun

​Recursos Principais

​Início Rápido

​Tipos de Fluxo de Checkout

​Manipulação de Eventos de Webhook

​Escolhendo o Adaptador Certo

​Obter Ajuda

Adaptadores de Framework Disponíveis

Recursos Principais

Início Rápido

Tipos de Fluxo de Checkout

Manipulação de Eventos de Webhook

Escolhendo o Adaptador Certo

Obter Ajuda