Översikt över ramverksadaptrar

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

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

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

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Documentation Index

​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