Übersicht der Framework-Adapter

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 es Ihnen, Dodo Payments in weniger als 10 Zeilen Code zu integrieren. Sie übernehmen automatisch die Authentifizierung, die Anforderungsanalyse und die Antwortformatierung.

Verfügbare Framework-Adapter

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

Next.js

Unterstützung des App Routers mit Routenhandlern für Checkout, Portal und Webhooks

Nuxt

Vue-basiertes Full-Stack-Framework mit Server-Routen-Integration

Express

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

Fastify

Hochleistungsfähiges Node.js-Framework mit Plugin-Architektur

Hono

Ultraleichtes Web-Framework für den Edge, Cloudflare Workers und mehr

Astro

Inhaltfokussiertes Framework mit Unterstützung für Server-Endpunkte

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 + Zahlungen

Convex

Backend-as-a-Service-Komponente für die Echtzeit-Zahlungssynchronisation

Kernfunktionen

Alle Framework-Adapter bieten diese integrierten Funktionen:

Funktion	Beschreibung
Checkout-Handler	Unterstützung für statische, dynamische und sitzungsbasierte Checkout-Flows
Kundenportal	Vorgefertigter Handler für Abonnement- und Rechnungsmanagement
Webhook-Handler	Sichere Signaturverifizierung mit typisierten Ereignis-Handlern
Umgebungsconfig	Einfache Einrichtung über Umgebungsvariablen
Typensicherheit	Vollständige TypeScript-Unterstützung mit typisierten Payloads

Schnellstart

Beginnen Sie mit jedem Framework-Adapter in drei Schritten:

Adapter installieren

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

Umgebungsvariablen konfigurieren

Fügen Sie Ihre Dodo Payments-Anmeldeinformationen 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"

Kommen Sie niemals Ihre .env Datei oder Geheimnisse in die Versionskontrolle ein.

Routen-Handler erstellen

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 jetzt bereit, Zahlungen zu verarbeiten! Besuchen Sie die einzelnen Adapterseiten für detaillierte Anleitungen und alle verfügbaren Optionen.

Checkout-Flow-Typen

Alle Adapter unterstützen drei Checkout-Flow-Typen:

Statischer Checkout (GET)

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

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

Unterstützt optionale Kundenvorbefüllung und Anpassung über Abfrageparameter.

Dynamischer Checkout (POST)

Verwenden Sie den dynamischen Checkout, um Zahlungen programmgesteuert mit benutzerdefinierten Details zu erstellen:

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

Unterstützt sowohl einmalige Zahlungen als auch Abonnements.

Checkout-Sitzungen (POST)

Verwenden Sie Checkout-Sitzungen für das flexibelste Checkout-Erlebnis mit Warenkorbsupport:

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

Erfahren Sie mehr im Leitfaden zu Checkout-Sitzungen.

Webhook-Ereignisverarbeitung

Alle Adapter bieten typensichere Webhook-Verarbeitung mit granularen Ereignis-Callbacks:

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-Schemas. Ungültige Anfragen werden mit entsprechenden Fehlercodes abgelehnt.

Den richtigen Adapter wählen

Framework	Am besten geeignet für	Laufzeit
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	Inhaltsseiten mit Server-Endpunkten	Node.js, Edge
SvelteKit	Full-Stack-Svelte-Anwendungen	Node.js
Remix	Full-Stack-React mit geschachtelter Routenführung	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 verwenden	Convex Runtime

Hilfe erhalten

Benötigen Sie Unterstützung bei 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 unser API-Referenz

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Verfügbare Framework-Adapter

Next.js

Nuxt

Express

Fastify

Hono

Astro

SvelteKit

Remix

TanStack Start

Better Auth

Convex

Kernfunktionen

Schnellstart

Checkout-Flow-Typen

Webhook-Ereignisverarbeitung

Den richtigen Adapter wählen

Hilfe erhalten

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

​Verfügbare Framework-Adapter

Next.js

Nuxt

Express

Fastify

Hono

Astro

SvelteKit

Remix

TanStack Start

Better Auth

Convex

​Kernfunktionen

​Schnellstart

​Checkout-Flow-Typen

​Webhook-Ereignisverarbeitung

​Den richtigen Adapter wählen

​Hilfe erhalten

Verfügbare Framework-Adapter

Kernfunktionen

Schnellstart

Checkout-Flow-Typen

Webhook-Ereignisverarbeitung

Den richtigen Adapter wählen

Hilfe erhalten