Ö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.

Ramverksadaptrar låter dig integrera Dodo Payments på mindre än 10 rader kod. De hanterar autentisering, begärningsparsing och svarformatering automatiskt.

Tillgängliga ramverksadaptrar

Välj den adapter som matchar ditt ramverk:

Next.js

App Router-stöd med ruttshanterare för kassa, portal och webhooks

Nuxt

Vue-baserat fullstack-ramverk med serverruttintegration

Express

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

Fastify

Högpresterande Node.js-ramverk med plugin-arkitektur

Hono

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

Astro

Innehållsfokuserat ramverk med stöd för serverändpunkter

SvelteKit

Fullstack Svelte-ramverk med serverhooks-integration

Remix

Fullstack React-ramverk med loader- och actionhanterare

TanStack Start

Typ-säker fullstack React-ramverk med serverfunktioner

Better Auth

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

Convex

Backend-as-a-Service-komponent för realtidsbetalningssynkronisering

Kärnfunktioner

Alla ramverksadaptrar tillhandahåller dessa inbyggda funktioner:

Funktion	Beskrivning
Kassa-hanterare	Stöd för statiska, dynamiska och sessionsbaserade kassaflöden
Kundportal	Förbyggd hanterare för prenumeration och fakturahantering
Webhook-hanterare	Säker signaturverifiering med typade händelsehanterare
Miljökonfiguration	Enkel installation via miljövariabler
Typ-säkerhet	Fullt TypeScript-stöd med typade payloads

Snabbstart

Kom igång med valfri ramverksadapter i tre steg:

Installera adaptern

Använd din paketförvaltare för att installera den ramverkspecifika 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

Konfigurera miljövariabler

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"

Kom aldrig att begå din .env fil eller hemligheter till versionskontroll.

Skapa ruttshanterare

Ställ in dina kassa-, kundportal- och webhook-rutter:

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

Du är nu redo att behandla betalningar! Besök de individuella adapter-sidorna för detaljerade guider och alla tillgängliga alternativ.

Kassatypflöden

Alla adaptrar stöder tre typer av kassaflöden:

Statisk kassa (GET)

Använd statisk kassa för enkla, delbara betalningslänkar. Skicka produkt-ID som en frågeparameter:

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

Stöder valfri kundförifyllning och anpassning via frågeparametrar.

Dynamisk kassa (POST)

Använd dynamisk kassa för att programmässigt 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.

Kassasessioner (POST)

Använd kassasessioner för den mest flexibla kassaupplevelsen 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 Kassasessioner Guide.

Webhook-händelsehantering

Alla adaptrar tillhandahåller typ-säker webhook-hantering med granulära händelseåterkopplingar:

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ärningar avvisas med lämpliga felkoder.

Välja rätt adapter

Ramverk	Bäst för	Körtid
Next.js	Fullstack React-appar med App Router	Node.js, Edge
Nuxt	Fullstack 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 serverändpunkter	Node.js, Edge
SvelteKit	Fullstack Svelte-applikationer	Node.js
Remix	Fullstack React med nästlad routing	Node.js
TanStack Start	Typ-säker fullstack React	Node.js
Better Auth	Appar som redan använder Better Auth	Olika
Convex	Appar som använder Convex för backend	Convex Runtime

Få hjälp

Behöver du hjälp med ramverksadaptrar?

Discord: Gå med i vår community-server för hjälp i realtid
E-post: Kontakta oss på support@dodopayments.com
GitHub: Öppna ett ärende på den respektive adapter-repositoriet
Dokumentation: Besök vår API-referens

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

Kärnfunktioner

Snabbstart

Kassatypflöden

Webhook-händelsehantering

Välja rätt adapter

Få hjälp

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

​Kärnfunktioner

​Snabbstart

​Kassatypflöden

​Webhook-händelsehantering

​Välja rätt adapter

​Få hjälp

Tillgängliga ramverksadaptrar

Kärnfunktioner

Snabbstart

Kassatypflöden

Webhook-händelsehantering

Välja rätt adapter

Få hjälp