Übersicht der Framework-Adapter - Dodo Payments Documentation

Dodo Payments bietet offizielle Framework-Adapter, die die Zahlungsintegration vereinfachen. Jeder Adapter ist so konzipiert, dass er nahtlos mit den Konventionen Ihres Frameworks funktioniert und Checkout, Kundenportal und Webhook-Verarbeitung sofort bereitstellt.

Framework-Adapter ermöglichen die Integration von Dodo Payments mit weniger als 10 Codezeilen. Sie übernehmen automatisch Authentifizierung, Anfrageanalyse und Antwortformatierung.

Verfügbare Framework-Adapter

Wählen Sie den Adapter, der zu Ihrem Framework passt:

Next.js

App-Router-Unterstützung mit Route-Handlern für Checkout, Portal und Webhooks

Nuxt

Vue-basiertes Full-Stack-Framework mit Integration von Serverrouten

Express

Middleware-basierte Handler für das beliebte Node.js-Framework

Fastify

Leistungsstarkes Node.js-Framework mit Plugin-Architektur

Hono

Ultraschnelles Webframework für Edge, Cloudflare Workers und mehr

Astro

Content-fokussiertes Framework mit Unterstützung für Serverendpunkte

SvelteKit

Full-Stack-Svelte-Framework mit Integration von Server-Hooks

Remix

Full-Stack-React-Framework mit Loader- und Action-Handlern

TanStack Start

Typensicheres Full-Stack-React-Framework mit Serverfunktionen

Better Auth

Authentifizierungs-Framework-Plugin für nahtlose Authentifizierung und Zahlungen

Convex

Backend-as-a-Service-Komponente für die Echtzeit-Synchronisation von Zahlungen

Bun

Native Bun.serve()-Handler für Checkout, Portal und Webhooks

Kernfunktionen

Alle Framework-Adapter bieten diese integrierten Funktionen:

Feature	Description
Checkout Handler	Unterstützung für statische, dynamische und sitzungsbasierte Checkout-Flows
Customer Portal	Vorgefertigter Handler für Abonnement- und Abrechnungsverwaltung
Webhook Handler	Sichere Signaturprüfung mit typisierten Ereignishandlern
Environment Config	Einfache Einrichtung über Umgebungsvariablen
Type Safety	Vollständige TypeScript-Unterstützung mit typisierten Payloads

Schnellstart

Starten Sie mit jedem Framework-Adapter in drei Schritten:

Install the Adaptor

Verwenden Sie Ihren Paketmanager, um den frameworkspezifischen Adapter zu installieren:

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

Fügen Sie Ihre Dodo Payments-Zugangsdaten zu Ihrer Umgebung hinzu:

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"

Committen Sie niemals Ihre .env-Datei oder Geheimnisse in die Versionskontrolle.

Create Route Handlers

Richten Sie Ihre Checkout-, Kundenportal- und Webhook-Routen ein:

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

Sie sind nun bereit, Zahlungen zu verarbeiten! Besuchen Sie die einzelnen Adapterseiten für detaillierte Anleitungen und alle verfügbaren Optionen.

Checkout-Flussarten

Alle Adapter unterstützen drei Checkout-Flussarten:

Static Checkout (GET)

Verwenden Sie statischen Checkout für einfache, teilbare Zahlungslinks. Übergeben Sie die Produkt-ID als Abfrageparameter:

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

Unterstützt optionales Vorausfüllen des Kunden und Anpassungen über Abfrageparameter.

Dynamic Checkout (POST)

Verwenden Sie dynamischen Checkout, um Zahlungen programmatisch mit individuellen Details zu erstellen:

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

Unterstützt Einmalzahlungen und Abonnements.

Checkout Sessions (POST)

Verwenden Sie Checkout-Sessions für die flexibelste Checkout-Erfahrung mit Warenkorb-Unterstützung:

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

Erfahren Sie mehr im Checkout Sessions Guide.

Webhook-Ereignisverarbeitung

Alle Adapter bieten typgesicherte Webhook-Verarbeitung mit granularer Ereignis-Callback-Steuerung:

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

Alle Webhook-Handler verifizieren automatisch Signaturen und validieren Payloads mithilfe von Zod-Schemata. Ungültige Anfragen werden mit entsprechenden Fehlercodes abgelehnt.

Die richtige Adapterwahl

Framework	Best For	Runtime
Next.js	Full-Stack-React-Apps mit App Router	Node.js, Edge
Nuxt	Full-Stack-Vue.js-Anwendungen	Node.js
Express	REST-APIs und traditionelle Node.js-Apps	Node.js
Fastify	Hochleistungs-APIs	Node.js
Hono	Edge-Bereitstellungen, Cloudflare Workers	Edge, Node.js
Astro	Content-Sites mit Serverendpunkten	Node.js, Edge
SvelteKit	Full-Stack-Svelte-Anwendungen	Node.js
Remix	Full-Stack-React mit verschachtelter Routing-Logik	Node.js
TanStack Start	Typensicheres Full-Stack-React	Node.js
Better Auth	Apps, die bereits Better Auth verwenden	Verschiedene
Convex	Apps, die Convex für das Backend nutzen	Convex Runtime
Bun	Native Bun-Serveranwendungen	Bun

Hilfe erhalten

Benötigen Sie Hilfe mit Framework-Adaptern?

Discord: Treten Sie unserem Community-Server für Echtzeit-Hilfe bei
E-Mail: Kontaktieren Sie uns unter support@dodopayments.com
GitHub: Öffnen Sie ein Issue im jeweiligen Adapter-Repository
Dokumentation: Besuchen Sie unsere API-Referenz

​Verfügbare Framework-Adapter

Next.js

Nuxt

Express

Fastify

Hono

Astro

SvelteKit

Remix

TanStack Start

Better Auth

Convex

Bun

​Kernfunktionen

​Schnellstart

​Checkout-Flussarten

​Webhook-Ereignisverarbeitung

​Die richtige Adapterwahl

​Hilfe erhalten

Verfügbare Framework-Adapter

Kernfunktionen

Schnellstart

Checkout-Flussarten

Webhook-Ereignisverarbeitung

Die richtige Adapterwahl

Hilfe erhalten