Panoramica degli Adattatori del Framework - Dodo Payments Documentation

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 Checkout	Supporto per flussi di checkout statici, dinamici e basati su sessione
Portale Cliente	Gestore predefinito per la gestione degli abbonamenti e della fatturazione
Gestore Webhook	Verifica sicura delle firme con gestori di eventi tipizzati
Configurazione Ambiente	Configurazione semplice tramite variabili d’ambiente
Sicurezza dei Tipi	Supporto completo a TypeScript con payload tipizzati

Avvio rapido

Inizia con qualsiasi adattatore del framework in tre passaggi:

Install the Adaptor

Usa il tuo gestore di pacchetti per installare l’adattatore specifico del 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

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.

Create Route Handlers

Configura le tue route di checkout, portale 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,
}));

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:

Static Checkout (GET)

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.

Dynamic Checkout (POST)

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.

Checkout Sessions (POST)

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

Framework	Ideale per	Runtime
Next.js	App React full-stack con App Router	Node.js, Edge
Nuxt	Applicazioni Vue.js full-stack	Node.js
Express	API REST e app Node.js tradizionali	Node.js
Fastify	API ad alte prestazioni	Node.js
Hono	Deployment su edge, Cloudflare Workers	Edge, Node.js
Astro	Siti di contenuti con endpoint server	Node.js, Edge
SvelteKit	Applicazioni Svelte full-stack	Node.js
Remix	React full-stack con routing nidificato	Node.js
TanStack Start	React full-stack con tipizzazione forte	Node.js
Better Auth	App già basate su Better Auth	Vari
Convex	App che usano Convex per il backend	Convex Runtime
Bun	Applicazioni server native su Bun	Bun

Ottenere supporto

Hai bisogno di assistenza con gli adattatori dei framework?

Discord: Unisciti al nostro server della community per aiuto in tempo reale
Email: Contattaci a support@dodopayments.com
GitHub: Apri una issue nel repository dell’adattatore pertinente
Documentazione: Visita la nostra API reference
Discord: Unisciti al nostro server della community per aiuto in tempo reale
Email: Contattaci a support@dodopayments.com
GitHub: Apri un problema nel rispettivo repository dell’adattatore
Documentazione: Visita la nostra riferimento API
Discord: Join our community server for real-time help
Email: Contact us at support@dodopayments.com
GitHub: Open an issue on the respective adaptor repository
Documentation: Visit our API reference

​Adattatori del Framework Disponibili

Next.js

Nuxt

Express

Fastify

Hono

Astro

SvelteKit

Remix

TanStack Start

Better Auth

Convex

Bun

​Funzionalità principali

​Avvio rapido

​Tipi di flusso di checkout

​Gestione degli eventi webhook

​Scegliere l’adattatore giusto

​Ottenere supporto

Adattatori del Framework Disponibili

Funzionalità principali

Avvio rapido

Tipi di flusso di checkout

Gestione degli eventi webhook

Scegliere l’adattatore giusto

Ottenere supporto