Panoramica degli Adattatori del Framework

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 del 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 per App Router con gestori di route per checkout, portale e webhook

Nuxt

Framework full-stack basato su Vue con integrazione delle route del 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

Astro

Framework incentrato sui contenuti con supporto per endpoint del server

SvelteKit

Framework Svelte full-stack con integrazione degli hook del server

Remix

Framework React full-stack con gestori di caricamento e azione

TanStack Start

Framework React full-stack a tipo sicuro con funzioni del server

Better Auth

Plugin per framework di autenticazione per un’autenticazione + pagamenti senza soluzione di continuità

Convex

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

Caratteristiche Principali

Tutti gli adattatori del framework forniscono queste funzionalità integrate:

Caratteristica	Descrizione
Gestore Checkout	Supporto per flussi di checkout statici, dinamici e basati su sessione
Portale Clienti	Gestore predefinito per la gestione di abbonamenti e fatturazione
Gestore Webhook	Verifica della firma sicura con gestori di eventi tipizzati
Configurazione Ambiente	Configurazione semplice tramite variabili d’ambiente
Sicurezza dei Tipi	Supporto completo per TypeScript con payload tipizzati

Inizio Veloce

Inizia con qualsiasi adattatore del framework in tre passaggi:

Installa l'Adattatore

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

Configura le Variabili d'Ambiente

Aggiungi le tue credenziali 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 impegnare mai il tuo .env file o segreti nel controllo di versione.

Crea Gestori di Route

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

Sei ora 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:

Checkout Statico (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 il precompilamento opzionale del cliente e la personalizzazione tramite parametri di query.

Checkout Dinamico (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 che abbonamenti.

Sessioni di Checkout (POST)

Usa le sessioni di checkout per l’esperienza di checkout più flessibile con supporto per il carrello:

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

Scopri di più nella Guida alle Sessioni di Checkout.

Gestione degli Eventi Webhook

Tutti gli adattatori forniscono gestione dei webhook a tipo sicuro con callback di 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 di 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	Migliore 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	Distribuzioni Edge, Cloudflare Workers	Edge, Node.js
Astro	Siti di contenuti con endpoint del 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 a tipo sicuro	Node.js
Better Auth	App che utilizzano già Better Auth	Vari
Convex	App che utilizzano Convex per il backend	Convex Runtime

Ottenere Aiuto

Hai bisogno di assistenza con gli adattatori del framework?

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

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Adattatori del Framework Disponibili

Next.js

Nuxt

Express

Fastify

Hono

Astro

SvelteKit

Remix

TanStack Start

Better Auth

Convex

Caratteristiche Principali

Inizio Veloce

Tipi di Flusso di Checkout

Gestione degli Eventi Webhook

Scegliere l’Adattatore Giusto

Ottenere Aiuto

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

​Adattatori del Framework Disponibili

Next.js

Nuxt

Express

Fastify

Hono

Astro

SvelteKit

Remix

TanStack Start

Better Auth

Convex

​Caratteristiche Principali

​Inizio Veloce

​Tipi di Flusso di Checkout

​Gestione degli Eventi Webhook

​Scegliere l’Adattatore Giusto

​Ottenere Aiuto

Adattatori del Framework Disponibili

Caratteristiche Principali

Inizio Veloce

Tipi di Flusso di Checkout

Gestione degli Eventi Webhook

Scegliere l’Adattatore Giusto

Ottenere Aiuto