Vai al contenuto principale
Dodo Payments fornisce adattatori ufficiali per framework che semplificano l’integrazione dei pagamenti. Ogni adattatore è progettato per funzionare senza problemi con le convenzioni del tuo framework, offrendo checkout, portale clienti e gestione dei webhook pronti all’uso.
Gli adattatori dei framework ti consentono di integrare Dodo Payments in meno di 10 righe di codice. Gestiscono automaticamente l’autenticazione, l’analisi delle richieste e la formattazione delle risposte.

​
Adattatori del Framework Disponibili

Scegli l’adattatore che corrisponde al tuo framework:

Next.js

Supporto App Router con gestori di route per checkout, portale e webhook

Nuxt

Framework full-stack basato su Vue con integrazione di route server

Express

Gestori basati su middleware per il popolare framework Node.js

Fastify

Framework Node.js ad alte prestazioni con architettura a plugin

Hono

Framework web ultrarapido per edge, Cloudflare Workers e altro ancora

Astro

Framework incentrato sui contenuti con supporto per endpoint server

SvelteKit

Framework full-stack Svelte con integrazione di hook server

Remix

Framework full-stack React con loader e gestori di azioni

TanStack Start

Framework full-stack React con tipizzazione forte e funzioni server

Better Auth

Plugin per framework di autenticazione per auth + pagamenti senza interruzioni

Convex

Componente Backend-as-a-Service per la sincronizzazione in tempo reale dei pagamenti

Bun

Gestori nativi Bun.serve() per checkout, portale e webhook

​
Funzionalità principali

Tutti gli adattatori dei framework offrono queste capacità integrate:
FunzionalitàDescrizione
Gestore CheckoutSupporto per flussi di checkout statici, dinamici e basati su sessione
Portale ClienteGestore predefinito per la gestione degli abbonamenti e della fatturazione
Gestore WebhookVerifica sicura delle firme con gestori di eventi tipizzati
Configurazione AmbienteConfigurazione semplice tramite variabili d’ambiente
Sicurezza dei TipiSupporto completo a TypeScript con payload tipizzati

​
Avvio rapido

Inizia con qualsiasi adattatore del framework in tre passaggi:
1

Install the Adaptor

Usa il tuo gestore di pacchetti per installare l’adattatore specifico del framework:
npm install @dodopayments/nextjs
2

Configure Environment Variables

Aggiungi le tue credenziali di Dodo Payments al tuo 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"
Non commettere mai il file .env o segreti nel controllo di versione.
3

Create Route Handlers

Configura le tue route di checkout, portale cliente e webhook:
// 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,
});
Ora sei pronto per elaborare i pagamenti! Visita le pagine degli adattatori individuali per guide dettagliate e tutte le opzioni disponibili.

​
Tipi di flusso di checkout

Tutti gli adattatori supportano tre tipi di flusso di checkout:
Usa il checkout statico per link di pagamento semplici e condivisibili. Passa l’ID del prodotto come parametro di query:
/api/checkout?productId=pdt_xxx&quantity=1
Supporta l’auto-compilazione facoltativa del cliente e la personalizzazione tramite parametri di query.
Usa il checkout dinamico per creare programmaticamente pagamenti con dettagli personalizzati:
{
  "product_id": "pdt_xxx",
  "customer": {
    "email": "customer@example.com",
    "name": "John Doe"
  },
  "quantity": 1
}
Supporta sia pagamenti una tantum sia abbonamenti.
Usa le sessioni di checkout per l’esperienza di checkout più flessibile con supporto al carrello:
{
  "product_cart": [
    { "product_id": "pdt_xxx", "quantity": 1 },
    { "product_id": "pdt_yyy", "quantity": 2 }
  ],
  "customer": {
    "email": "customer@example.com"
  }
}
Scopri di più nella Checkout Sessions Guide.

​
Gestione degli eventi webhook

Tutti gli adattatori offrono gestione dei webhook con tipizzazione sicura e callback per eventi granulari: 
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
});
Tutti i gestori webhook verificano automaticamente le firme e convalidano i payload utilizzando schemi Zod. Le richieste non valide vengono rifiutate con codici di errore appropriati.

​
Scegliere l’adattatore giusto

FrameworkIdeale perRuntime
Next.jsApp React full-stack con App RouterNode.js, Edge
NuxtApplicazioni Vue.js full-stackNode.js
ExpressAPI REST e app Node.js tradizionaliNode.js
FastifyAPI ad alte prestazioniNode.js
HonoDeployment su edge, Cloudflare WorkersEdge, Node.js
AstroSiti di contenuti con endpoint serverNode.js, Edge
SvelteKitApplicazioni Svelte full-stackNode.js
RemixReact full-stack con routing nidificatoNode.js
TanStack StartReact full-stack con tipizzazione forteNode.js
Better AuthApp già basate su Better AuthVari
ConvexApp che usano Convex per il backendConvex Runtime
BunApplicazioni server native su BunBun

​
Ottenere supporto

Hai bisogno di assistenza con gli adattatori dei framework?