Visão Geral dos Adaptadores de Framework

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.

Os adaptadores de framework permitem que você integre Dodo Payments em menos de 10 linhas de código. Eles lidam automaticamente com autenticação, análise de solicitaçõ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 rotas 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 alto desempenho com arquitetura de plugins

Hono

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

Astro

Framework focado em conteúdo com suporte a endpoints de servidor

SvelteKit

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

Remix

Framework React full-stack com manipuladores de carregamento e ação

TanStack Start

Framework React full-stack com segurança de tipo e funções de servidor

Better Auth

Plugin de framework de autenticação para autenticação + pagamentos sem costura

Convex

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

Recursos Principais

Todos os adaptadores de framework fornecem essas capacidades integradas:

Recurso	Descrição
Manipulador de Checkout	Suporte para fluxos de checkout estáticos, dinâmicos e baseados em sessão
Portal do Cliente	Manipulador pré-construído para gerenciamento de assinaturas e faturamento
Manipulador de Webhook	Verificação de assinatura segura com manipuladores de eventos tipados
Configuração de Ambiente	Configuração simples via variáveis de ambiente
Segurança de Tipo	Suporte total ao TypeScript com payloads tipados

Começo Rápido

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

Instalar o Adaptador

Use seu 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

Configurar Variáveis de Ambiente

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 comite seu .env arquivo ou segredos no controle de versão.

Criar Manipuladores de Rota

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

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,
}));

Você está agora pronto para processar pagamentos! Visite as páginas dos adaptadores individuais 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:

Checkout Estático (GET)

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

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

Suporta preenchimento opcional de cliente e personalização via parâmetros de consulta.

Checkout Dinâmico (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.

Sessões de Checkout (POST)

Use sessões de checkout para a experiência de checkout 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 fornecem manipulação de webhook segura em termos de tipo com 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 as assinaturas e validam os payloads usando esquemas Zod. Solicitações inválidas são rejeitadas com códigos de erro apropriados.

Escolhendo o Adaptador Certo

Framework	Melhor Para	Tempo de Execução
Next.js	Aplicativos React full-stack com App Router	Node.js, Edge
Nuxt	Aplicações Vue.js full-stack	Node.js
Express	APIs REST e aplicativos Node.js tradicionais	Node.js
Fastify	APIs de alto desempenho	Node.js
Hono	Implantações 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 roteamento aninhado	Node.js
TanStack Start	React full-stack seguro em tipos	Node.js
Better Auth	Aplicativos que já usam Better Auth	Vários
Convex	Aplicativos que usam Convex para backend	Convex Runtime

Obtendo Ajuda

Precisa de assistência com adaptadores de framework?

Discord: Junte-se ao nosso servidor da comunidade para ajuda em tempo real
Email: Entre em contato conosco em support@dodopayments.com
GitHub: Abra uma issue no repositório do adaptador respectivo
Documentação: Visite nossa referência de API

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Adaptadores de Framework Disponíveis

Next.js

Nuxt

Express

Fastify

Hono

Astro

SvelteKit

Remix

TanStack Start

Better Auth

Convex

Recursos Principais

Começo Rápido

Tipos de Fluxo de Checkout

Manipulação de Eventos de Webhook

Escolhendo o Adaptador Certo

Obtendo Ajuda

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

​Adaptadores de Framework Disponíveis

Next.js

Nuxt

Express

Fastify

Hono

Astro

SvelteKit

Remix

TanStack Start

Better Auth

Convex

​Recursos Principais

​Começo Rápido

​Tipos de Fluxo de Checkout

​Manipulação de Eventos de Webhook

​Escolhendo o Adaptador Certo

​Obtendo Ajuda

Adaptadores de Framework Disponíveis

Recursos Principais

Começo Rápido

Tipos de Fluxo de Checkout

Manipulação de Eventos de Webhook

Escolhendo o Adaptador Certo

Obtendo Ajuda