Aperçu des Adaptateurs de Framework

Dodo Payments fournit des adaptateurs de framework officiels qui simplifient l’intégration des paiements. Chaque adaptateur est conçu pour fonctionner de manière transparente avec les conventions de votre framework, offrant des fonctionnalités de paiement, de portail client et de gestion des webhooks dès le départ.

Les adaptateurs de framework vous permettent d’intégrer Dodo Payments en moins de 10 lignes de code. Ils gèrent automatiquement l’authentification, l’analyse des requêtes et le formatage des réponses.

Adaptateurs de Framework Disponibles

Choisissez l’adaptateur qui correspond à votre framework :

Next.js

Support du routeur d’application avec des gestionnaires de routes pour le paiement, le portail et les webhooks

Nuxt

Framework full-stack basé sur Vue avec intégration des routes serveur

Express

Gestionnaires basés sur des middleware pour le framework Node.js populaire

Fastify

Framework Node.js haute performance avec architecture de plugins

Hono

Framework web ultrarapide pour l’edge, Cloudflare Workers, et plus

Astro

Framework axé sur le contenu avec support des points de terminaison serveur

SvelteKit

Framework Svelte full-stack avec intégration des hooks serveur

Remix

Framework React full-stack avec gestionnaires de chargement et d’action

TanStack Start

Framework React full-stack type-safe avec fonctions serveur

Better Auth

Plugin de framework d’authentification pour une authentification + paiements sans faille

Convex

Composant Backend-as-a-Service pour la synchronisation des paiements en temps réel

Fonctionnalités Principales

Tous les adaptateurs de framework fournissent ces capacités intégrées :

Fonctionnalité	Description
Gestionnaire de Paiement	Support pour les flux de paiement statiques, dynamiques et basés sur des sessions
Portail Client	Gestionnaire préconstruit pour la gestion des abonnements et de la facturation
Gestionnaire de Webhook	Vérification de signature sécurisée avec gestionnaires d’événements typés
Configuration d’Environnement	Configuration simple via des variables d’environnement
Sécurité de Type	Support complet de TypeScript avec des charges utiles typées

Démarrage Rapide

Commencez avec n’importe quel adaptateur de framework en trois étapes :

Installer l'Adaptateur

Utilisez votre gestionnaire de paquets pour installer l’adaptateur spécifique au framework :

npm install @dodopayments/nextjs

npm install @dodopayments/nuxt

npm install @dodopayments/express

npm install @dodopayments/hono

npm install @dodopayments/astro

npm install @dodopayments/sveltekit

Configurer les Variables d'Environnement

Ajoutez vos identifiants Dodo Payments à votre environnement :

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"

Ne jamais commettre votre .env fichier ou secrets dans le contrôle de version.

Créer des Gestionnaires de Routes

Configurez vos routes de paiement, de portail client et de webhook :

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

Vous êtes maintenant prêt à traiter les paiements ! Visitez les pages des adaptateurs individuels pour des guides détaillés et toutes les options disponibles.

Types de Flux de Paiement

Tous les adaptateurs supportent trois types de flux de paiement :

Paiement Statique (GET)

Utilisez le paiement statique pour des liens de paiement simples et partageables. Passez l’ID du produit comme paramètre de requête :

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

Supporte le pré-remplissage et la personnalisation optionnels via des paramètres de requête.

Paiement Dynamique (POST)

Utilisez le paiement dynamique pour créer des paiements de manière programmatique avec des détails personnalisés :

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

Supporte à la fois les paiements uniques et les abonnements.

Sessions de Paiement (POST)

Utilisez les sessions de paiement pour l’expérience de paiement la plus flexible avec support du panier :

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

En savoir plus dans le Guide des Sessions de Paiement.

Gestion des Événements Webhook

Tous les adaptateurs fournissent une gestion de webhook sécurisée par type avec des rappels d’événements granulaires :

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

Tous les gestionnaires de webhook vérifient automatiquement les signatures et valident les charges utiles à l’aide de schémas Zod. Les requêtes invalides sont rejetées avec des codes d’erreur appropriés.

Choisir le Bon Adaptateur

Framework	Meilleur Pour	Runtime
Next.js	Applications React full-stack avec App Router	Node.js, Edge
Nuxt	Applications Vue.js full-stack	Node.js
Express	APIs REST et applications Node.js traditionnelles	Node.js
Fastify	APIs haute performance	Node.js
Hono	Déploiements Edge, Cloudflare Workers	Edge, Node.js
Astro	Sites de contenu avec points de terminaison serveur	Node.js, Edge
SvelteKit	Applications Svelte full-stack	Node.js
Remix	React full-stack avec routage imbriqué	Node.js
TanStack Start	React full-stack type-safe	Node.js
Better Auth	Applications utilisant déjà Better Auth	Divers
Convex	Applications utilisant Convex pour le backend	Convex Runtime

Obtenir de l’Aide

Besoin d’assistance avec les adaptateurs de framework ?

Discord : Rejoignez notre serveur communautaire pour une aide en temps réel
Email : Contactez-nous à support@dodopayments.com
GitHub : Ouvrez un problème sur le dépôt de l’adaptateur respectif
Documentation : Visitez notre référence API

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Adaptateurs de Framework Disponibles

Next.js

Nuxt

Express

Fastify

Hono

Astro

SvelteKit

Remix

TanStack Start

Better Auth

Convex

Fonctionnalités Principales

Démarrage Rapide

Types de Flux de Paiement

Gestion des Événements Webhook

Choisir le Bon Adaptateur

Obtenir de l’Aide

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

​Adaptateurs de Framework Disponibles

Next.js

Nuxt

Express

Fastify

Hono

Astro

SvelteKit

Remix

TanStack Start

Better Auth

Convex

​Fonctionnalités Principales

​Démarrage Rapide

​Types de Flux de Paiement

​Gestion des Événements Webhook

​Choisir le Bon Adaptateur

​Obtenir de l’Aide

Adaptateurs de Framework Disponibles

Fonctionnalités Principales

Démarrage Rapide

Types de Flux de Paiement

Gestion des Événements Webhook

Choisir le Bon Adaptateur

Obtenir de l’Aide