Översikt över ramverksadaptrar - Dodo Payments Documentation

Dodo Payments tillhandahåller officiella ramverksadaptrar som förenklar betalningsintegration. Varje adapter är utformad för att fungera sömlöst med ditt ramverks konventioner och erbjuder kassa, kundportal och webhook-hantering direkt ur lådan.

Rammeradaptrar låter dig integrera Dodo Payments med under 10 kodrader. De hanterar autentisering, förfrågningsanalys och svarformatering automatiskt.

Tillgängliga ramverksadaptrar

Välj den adapter som matchar ditt ramverk:

Next.js

App Router-stöd med route-handlers för checkout, portal och webhookar

Nuxt

Vue-baserat fullstackramverk med integration för serverrutter

Express

Mellanvarubaserade hanterare för det populära Node.js-ramverket

Fastify

Högpresterande Node.js-ramverk med pluginarkitektur

Hono

Ultrafast webb-ramverk för edge, Cloudflare Workers och mer

Astro

Innehållsfokuserat ramverk med stöd för serverendpoints

SvelteKit

Fullstack Svelte-ramverk med integration för serverhooks

Remix

Fullstack React-ramverk med loader- och actionhanterare

TanStack Start

Typsäkert fullstack React-ramverk med serverfunktioner

Better Auth

Autentiseringsramverksplugin för sömlös auth + betalningar

Convex

Backend-as-a-Service-komponent för synkronisering av betalningar i realtid

Bun

Native Bun.serve()-hanterare för checkout, portal och webhookar

Kärnfunktioner

Alla ramverksadaptrar erbjuder dessa inbyggda funktioner:

Funktion	Beskrivning
Checkout Handler	Stöd för statiska, dynamiska och sessionsbaserade checkout-flöden
Customer Portal	Förbyggd handler för prenumerations- och faktureringshantering
Webhook Handler	Säker signaturverifiering med typade händelsehanterare
Environment Config	Enkel konfiguration via miljövariabler
Type Safety	Fullt TypeScript-stöd med typade payloads

Kom igång snabbt

Kom igång med valfri ramverksadapter i tre steg:

Install the Adaptor

Använd din pakethanterare för att installera den ramverksspecifika adaptern:

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

Lägg till dina Dodo Payments-uppgifter i din miljö:

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"

Låt aldrig .env-filen eller hemligheter hamna i versionskontroll.

Create Route Handlers

Konfigurera dina checkout-, kundportal- och webhookrutter:

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

Nu är du redo att behandla betalningar! Besök de individuella adapteridorna för detaljerade guider och alla tillgängliga alternativ.

Typer av checkout-flöden

Alla adaptrar stöder tre typer av checkout-flöden:

Static Checkout (GET)

Använd statisk checkout för enkla, delbara betalningslänkar. Skicka produkt-ID:t som en query-parameter:

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

Stöder valfri förifyllning av kund och anpassning via query-parametrar.

Dynamic Checkout (POST)

Använd dynamisk checkout för att programatiskt skapa betalningar med anpassade detaljer:

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

Stöder både engångsbetalningar och prenumerationer.

Checkout Sessions (POST)

Använd checkout-sessioner för den mest flexibla checkout-upplevelsen med kundvagnsstöd:

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

Läs mer i Checkout Sessions Guide.

Webhook-händelsehantering

Alla adaptrar erbjuder typsäker webhook-hantering med granulära händelseåteranrop:

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

Alla webhook-hanterare verifierar automatiskt signaturer och validerar payloads med Zod-scheman. Ogiltiga begäran avvisas med lämpliga felkoder.

Välja rätt adapter

Ramverk	Bäst för	Körmiljö
Next.js	Full-stack React-appar med App Router	Node.js, Edge
Nuxt	Full-stack Vue.js-applikationer	Node.js
Express	REST-API:er och traditionella Node.js-appar	Node.js
Fastify	Högpresterande API:er	Node.js
Hono	Edge-distributioner, Cloudflare Workers	Edge, Node.js
Astro	Innehållssajter med serverendpoints	Node.js, Edge
SvelteKit	Full-stack Svelte-applikationer	Node.js
Remix	Full-stack React med nästlad routing	Node.js
TanStack Start	Typsäker full-stack React	Node.js
Better Auth	Appar som redan använder Better Auth	Various
Convex	Appar som använder Convex för backend	Convex Runtime
Bun	Native Bun-serverapplikationer	Bun

Få hjälp

Behöver du hjälp med ramverksadaptrar?

Discord: Gå med i vår community server för livehjälp
Email: Kontakta oss på support@dodopayments.com
GitHub: Öppna en issue i respektive adapterrepository
Documentation: Besök vår API reference

​Tillgängliga ramverksadaptrar

Next.js

Nuxt

Express

Fastify

Hono

Astro

SvelteKit

Remix

TanStack Start

Better Auth

Convex

Bun

​Kärnfunktioner

​Kom igång snabbt

​Typer av checkout-flöden

​Webhook-händelsehantering

​Välja rätt adapter

​Få hjälp

Tillgängliga ramverksadaptrar

Kärnfunktioner

Kom igång snabbt

Typer av checkout-flöden

Webhook-händelsehantering

Välja rätt adapter

Få hjälp