v1.70.0 (24 décembre 2025) - Dodo Payments Documentation

Nouvelles fonctionnalités 🚀

Paiement en ligne - Expériences de paiement entièrement intégrées (BETA) Intégrez le paiement Dodo Payments directement dans votre site Web pour une expérience de paiement fluide et de marque. Contrairement au paiement en superposition qui s’ouvre sous forme de modal, le paiement en ligne intègre le formulaire de paiement directement dans la mise en page de votre page.

Avantages
- Entièrement intégré : Créez des expériences de paiement qui se fondent parfaitement dans votre site Web
- Résumé de commande personnalisé : Créez une interface utilisateur personnalisée qui se synchronise avec le paiement en temps réel
- Contrôle maximal : Contrôle total sur la mise en page et le design du paiement
- Conforme PCI : Dodo Payments gère en toute sécurité toutes les informations de paiement sensibles
- Synchronisation en temps réel : Utilisez les événements SDK pour garder votre interface utilisateur synchronisée avec l’état du paiement
Comment ça fonctionne
Initialisez le SDK avec displayType: 'inline' et intégrez le paiement dans un élément conteneur :
```
import { DodoPayments } from "dodopayments-checkout";

// Initialize the SDK for inline mode
DodoPayments.Initialize({
  mode: "test",
  displayType: "inline",
  onEvent: (event) => {
    if (event.event_type === "checkout.breakdown") {
      // Update your UI with real-time tax and total calculations
      const breakdown = event.data?.message;
    }
  },
});

// Open checkout in a specific container
DodoPayments.Checkout.open({
  checkoutUrl: "https://test.dodopayments.com/session/cks_123",
  elementId: "dodo-inline-checkout" // ID of the container element
});
```
Fonctionnalités clés
- Événements de décomposition en temps réel : Recevez checkout.breakdown événements lorsque les clients saisissent leurs informations
- Résumé de commande personnalisé : Créez votre propre affichage de prix qui se met à jour en temps réel
- Intégration transparente : Le cadre de paiement gère la collecte des paiements pendant que vous contrôlez la mise en page
- Méthodes SDK : Utilisez open(), close(), et isOpen() pour contrôler le paiement de manière programmatique
Résultat : Expériences de paiement entièrement intégrées qui correspondent à votre marque et offrent un contrôle maximal sur le flux de paiement.

Utilisez le paiement en ligne lorsque vous souhaitez un contrôle maximal sur le design du paiement. Utilisez le paiement en superposition pour une intégration plus rapide avec des modifications minimales des pages existantes.
En savoir plus : Guide du paiement en ligne
Créer des paiements, des abonnements et des paiements en utilisant des méthodes de paiement existantes
Rationalisez les flux de paiement en utilisant les méthodes de paiement enregistrées des clients existants. Le nouveau payment_method_id paramètre vous permet de créer des paiements, des abonnements ou des sessions de paiement en utilisant la méthode de paiement précédemment enregistrée d’un client.

Avantages
- Paiement plus rapide : Évitez la collecte de la méthode de paiement pour les clients récurrents
- Achats en un clic : Activez les achats instantanés avec des méthodes de paiement enregistrées
- Gestion des abonnements : Créez facilement des abonnements en utilisant des méthodes de paiement existantes
- Amélioration de la conversion : Réduisez les frictions de paiement pour les clients récurrents
Comment ça fonctionne
Utilisez payment_method_id lors de la création de sessions de paiement, de paiements ou d’abonnements :
- Sessions de paiement
- Paiements uniques
- Abonnements
const session = await client.checkoutSessions.create({ product_cart: [{ product_id: 'prod_123', quantity: 1 }], customer: { customer_id: 'cus_123' }, payment_method_id: 'pm_abc123', confirm: true });
const payment = await client.payments.create({ product_cart: [{ product_id: 'prod_123', quantity: 1 }], customer_id: 'cus_123', payment_method_id: 'pm_abc123' });
const subscription = await client.subscriptions.create({ customer_id: 'cus_123', product_id: 'prod_subscription', payment_method_id: 'pm_abc123' });
Lors de l’utilisation de payment_method_id dans les sessions de paiement, confirm doit être défini sur true, et une customer_id existante doit être fournie. La méthode de paiement sera validée pour son éligibilité avec la devise du paiement.

La méthode de paiement doit appartenir au client et être compatible avec la devise du paiement. Si la validation échoue, la demande renverra une erreur.
Modifications des plans d’abonnement dans le tableau de bord avec mises à jour de la date de facturation suivante Gérez les plans d’abonnement directement depuis le tableau de bord avec un contrôle amélioré. Vous pouvez désormais modifier les plans d’abonnement et mettre à jour la date de facturation suivante en une seule action, vous offrant une flexibilité totale dans la gestion des abonnements.

Fonctionnalités du tableau de bord
- Changements de plan : Améliorez ou dégradez les abonnements d’un simple clic
- Contrôle de la date de facturation : Mettez à jour la date de facturation suivante lors du changement de plans
- Options de prorata : Choisissez comment gérer le prorata lors du changement de plans
- Aperçu visuel : Voyez exactement comment les changements de plan affectent la facturation avant de confirmer
Cas d’utilisation
- Support client : Ajustez rapidement les plans d’abonnement pour les demandes des clients
- Améliorations promotionnelles : Améliorez temporairement les clients avec des dates de facturation spécifiques
- Migrations de plan : Transitionnez en douceur les clients entre les niveaux d’abonnement
- Alignement de la facturation : Alignez les dates de facturation sur plusieurs abonnements
Résultat : Contrôle complet de la gestion des abonnements depuis le tableau de bord, réduisant le besoin d’appels API pour les ajustements d’abonnement courants.

Utilisez le tableau de bord pour des changements rapides de plans d’abonnement, et l’API pour une gestion programmatique des abonnements dans votre application.
Liens courts pour les URL de paiement
Générez des liens de paiement plus propres et plus partageables avec notre nouvelle fonctionnalité de lien court. Les liens courts fournissent des URL de paiement raccourcies avec des slugs personnalisés, les rendant plus faciles à partager avec les clients ou à intégrer sur votre site Web.

Avantages
- URLs plus propres : Remplacez les longues URL de paiement par des liens courts et de marque
- Meilleure confiance : Liens au look professionnel qui renforcent la confiance des clients
- Partage plus facile : URLs simplifiées parfaites pour SMS, email ou réseaux sociaux
- Slugs personnalisés : Créez des liens courts mémorables et de marque pour vos produits
Comment ça fonctionne
Activez les liens courts lors de la création de sessions de paiement ou de liens de paiement :
- Sessions de paiement
- Liens de paiement
const session = await client.checkoutSessions.create({ product_cart: [{ product_id: 'prod_123', quantity: 1 }], short_link: true, return_url: 'https://yourapp.com/success' });
const payment = await client.payments.create({ product_cart: [{ product_id: 'prod_123', quantity: 1 }], short_link: true, return_url: 'https://yourapp.com/success' });
Résultat : Un lien de paiement raccourci qui est plus facile à partager et au look plus professionnel, améliorant les taux de conversion et la confiance des clients.

Les liens courts sont gérés dans votre tableau de bord et peuvent être consultés via l’API Liste des liens courts.
redirect_immediately Drapeau - Sauter la page de succès de paiement
Contrôlez le flux de paiement avec le nouveau redirect_immediately drapeau. Lorsqu’il est activé, les clients sont redirigés immédiatement après la finalisation du paiement, contournant la page de succès par défaut pour une expérience plus rapide et plus fluide.

Cas d’utilisation
- Flux de paiement plus rapide : Réduisez les frictions en sautant les pages intermédiaires
- Pages de succès personnalisées : Redirigez directement vers votre page de succès de marque
- Optimisation mobile : Améliorez l’expérience de paiement mobile avec des redirections immédiates
- Paiements intégrés : Intégrez parfaitement avec les flux de paiement en superposition ou intégrés
Comment ça fonctionne
Activez les redirections immédiates dans les sessions de paiement, les paiements ou les abonnements :
- Sessions de paiement
- Paiements uniques
- Abonnements
const session = await client.checkoutSessions.create({ product_cart: [{ product_id: 'prod_123', quantity: 1 }], redirect_immediately: true, return_url: 'https://yourapp.com/success' });
const payment = await client.payments.create({ product_cart: [{ product_id: 'prod_123', quantity: 1 }], redirect_immediately: true, return_url: 'https://yourapp.com/success' });
const subscription = await client.subscriptions.create({ customer_id: 'cus_123', product_id: 'prod_subscription', redirect_immediately: true, return_url: 'https://yourapp.com/success' });
Utilisez redirect_immediately: true lorsque vous avez une page de succès personnalisée qui offre une meilleure expérience utilisateur que la page de succès de paiement par défaut.

Lorsque redirect_immediately est activé, les clients sont redirigés vers votre return_url immédiatement après la finalisation du paiement, contournant complètement la page de succès par défaut.
Abonnements à la demande - Disponibles pour toutes les entreprises
Les abonnements à la demande sont désormais activés pour toutes les entreprises, vous offrant un contrôle de facturation flexible pour les services basés sur l’utilisation et mesurés.

Ce que cela permet
- Facturation basée sur l’utilisation : Créez des abonnements et facturez les clients en fonction de l’utilisation réelle
- Cycles de facturation flexibles : Facturez les clients à la demande plutôt qu’à des intervalles fixes
- Services mesurés : Parfait pour l’utilisation d’API, le stockage, le temps de calcul et d’autres ressources mesurées
- Contrôle manuel des charges : Créez des charges manuellement lorsque nécessaire, vous donnant un contrôle total sur le timing de la facturation
Comment ça fonctionne
Créez un abonnement à la demande et facturez les clients selon les besoins :
```
// Create an on-demand subscription
const subscription = await client.subscriptions.create({
  customer_id: 'cus_123',
  product_id: 'prod_api_access',
  on_demand: true
});

// Charge the customer when usage occurs
await client.subscriptions.createCharge(subscription.id, {
  amount: 4900,
  currency: 'USD',
  description: 'API usage for September: 1,000 requests'
});
```
Résultat : Contrôle total sur quand et combien facturer aux clients, parfait pour les modèles commerciaux basés sur l’utilisation.
En savoir plus : Abonnements à la demande
Corrections de bogues générales et améliorations
Cette version comprend des améliorations de performance, un polissage de l’interface utilisateur et résout des bogues mineurs pour une expérience plus fiable et fluide.

v1.67.0 (17 décembre 2025)Paiement de panier mixte pour produits uniques et d'abonnement, Portail Client Unifié, invoice_id dans la Réponse de Paiement

⌘I

Nouvelles fonctionnalités 🚀
Avantages
Comment ça fonctionne
Fonctionnalités clés
Avantages
Comment ça fonctionne
Fonctionnalités du tableau de bord
Cas d’utilisation
Avantages
Comment ça fonctionne
Cas d’utilisation
Comment ça fonctionne
Ce que cela permet
Comment ça fonctionne