Portail Client - Dodo Payments Documentation

Le Customer Portal est un site hébergé où vos clients gèrent leurs abonnements, consultent et téléchargent leurs factures et récupèrent leurs clés de licence sans contacter l’assistance.

Create Portal Session (API)

Créez un lien de portail pour un client, valable 24 heures.

Subscriptions

Forfaits récurrents, mises à niveau, rétrogradations et modules complémentaires.

Customer Portal repensé affichant les abonnements actifs, les moyens de paiement et l'historique de facturation

Qu’est-ce que le Customer Portal ?

Le portail est un site en libre-service, personnalisé avec le nom de votre entreprise, où les clients peuvent :

Accéder à l’historique de facturation : consulter les paiements passés et télécharger les factures.
Gérer les abonnements : consulter les détails d’un abonnement, le mettre en pause et le reprendre, ou l’annuler immédiatement ou à la prochaine date de facturation, selon vos paramètres.
Mettre à jour les moyens de paiement : modifier le moyen de paiement d’un abonnement ou réactiver un abonnement suspendu.
Récupérer les clés de licence : consulter les clés de licence associées à leurs achats.
Revenir à votre application : lorsque vous transmettez un return_url, le portail affiche un lien de retour vers votre entreprise. Sur mobile, une flèche de retour dans l’en-tête ramène à la vue d’ensemble du portail.

Si vous bloquez un client, son portail devient accessible en lecture seule. Il peut toujours se connecter et consulter ses factures, abonnements et clés de licence, mais il ne peut pas annuler, mettre en pause ou reprendre un abonnement, changer de forfait ni mettre à jour un moyen de paiement. Le profil du portail renvoie read_only: true afin qu’une intégration personnalisée puisse désactiver ses propres contrôles.

Avantages clés

Moins de demandes d’assistance : les clients gèrent eux-mêmes les demandes de facturation courantes.
Accès plus rapide : les clients obtiennent leurs factures et clés de licence dès leur connexion.
Risque de perte de clients réduit : les clients voient les dates de renouvellement et les détails du forfait avant d’être facturés.
Liens signés et à expiration : chaque lien de connexion est signé et expire après 24 heures.
Expérience localisée : le portail est disponible en 21 langues et en sélectionne une à partir des paramètres du navigateur du client.

Méthodes d’accès

Les clients accèdent au portail via un lien statique ou dynamique.

Lien statique (accès par e-mail)

Le lien statique n’expire jamais. Le client l’ouvre, saisit son adresse e-mail et reçoit un lien de connexion par e-mail. Le lien statique dépend de l’environnement : Mode test (pour les tests et le développement) :

https://test.customer.dodopayments.com/login/{business_id}

Mode live (pour la production avec de vraies transactions) :

https://customer.dodopayments.com/login/{business_id}

Remplacez {business_id} par l’identifiant de votre entreprise, puis partagez le lien avec vos clients. Le lien statique de la boîte de dialogue Partager l’invitation le contient déjà.

Merchant Flow

Accédez à Ventes → Clients et ouvrez un client, ou utilisez la colonne Inviter de la liste.
Cliquez sur Partager l’invitation.
Copiez le Lien statique et partagez-le avec votre client.

Customer Flow

Ouvrez le lien statique.
Saisissez l’adresse e-mail utilisée lors de l’achat et cliquez sur Obtenir le lien d’accès.
Ouvrez le lien de connexion reçu par e-mail. Il est valable 24 heures.

La page affiche toujours la même confirmation. Dodo Payments n’envoie un lien que lorsque l’adresse appartient à un client de votre entreprise ; la page ne révèle donc pas qui sont vos clients.

Les e-mails de connexion ne sont pas envoyés en mode test. Pour ouvrir un portail en mode test, utilisez le Lien dynamique ou créez une session via l’API.

Lien dynamique (lien magique)

Un lien dynamique connecte directement un client au portail, sans étape d’e-mail. Il expire 24 heures après sa création.

Un lien dynamique cesse de fonctionner après 24 heures. À son expiration, le client voit une page d’expiration. Générez un nouveau lien et envoyez-le à nouveau.

Merchant Flow

Accédez à Ventes → Clients et ouvrez le client.
Cliquez sur Partager l’invitation.
Copiez le Lien dynamique et partagez-le avec votre client.

Customer Flow

Ouvrez le lien dynamique.
Le Customer Portal s’ouvre directement, sans adresse e-mail.

Fonctionnalités du portail

La vue d’ensemble du portail tient sur une seule page. Sur ordinateur, un panneau à gauche décrit le portail. La zone principale répertorie les abonnements, moyens de paiement et l’historique de facturation du client.

Active Subscriptions

Chaque abonnement affiche le nom de son forfait, son prix, sa date de renouvellement et sa validité. Gérer l’abonnement ouvre ses détails, où le client peut modifier les informations de facturation, changer de forfait, mettre en pause ou annuler.

Payment Methods

Moyens de paiement enregistrés, comme les cartes avec leur réseau et leurs quatre derniers chiffres, UPI, portefeuilles et moyens bancaires. Modifiez le moyen de paiement d’un abonnement depuis sa page de détails.

Billing History

Chaque paiement apparaît dans un tableau avec les colonnes Date, Statut, Montant, Type de tarification, Droits et le téléchargement de la Facture.

Billing Information

Nom, e-mail, numéro de téléphone et adresse de facturation, affichés sur la page de détails de l’abonnement. Les clients peuvent modifier le nom et l’adresse de facturation.

Vue d’ensemble du portail

La page d’ensemble affiche les abonnements actifs, les moyens de paiement enregistrés et l’historique de facturation dans une seule vue défilante.

Page principale du Customer Portal affichant les abonnements actifs et les modes de paiement

Modes de paiement et historique de facturation

Plus bas sur la page se trouvent les moyens de paiement enregistrés et l’historique de facturation, avec un statut pour chaque paiement et un lien de téléchargement pour chaque facture.

Prise en charge des langues

Le Customer Portal est disponible en 21 langues, afin que les clients puissent gérer leurs abonnements, moyens de paiement et historique de facturation dans leur propre langue.

Fonctionnement de la sélection de la langue

Détection automatique : lors de la première visite, le portail lit la langue préférée du navigateur et la charge si elle est prise en charge. Sinon, il utilise l’anglais.
Remplacement manuel : les clients peuvent changer de langue à tout moment grâce au sélecteur de langue situé dans l’angle inférieur droit de la page, sur ordinateur comme sur mobile.
Préférence conservée : le portail stocke le choix dans le cookie NEXT_LOCALE pendant un an et mémorise ainsi la langue entre les visites.

Langues prises en charge

Langue	Code	Langue	Code
Anglais (par défaut)	`en`	Indonésien	`id`
Arabe	`ar`	Italien	`it`
Catalan	`ca`	Japonais	`ja`
Chinois	`zh`	Coréen	`ko`
Néerlandais	`nl`	Malais	`ms`
Français	`fr`	Polonais	`pl`
Allemand	`de`	Portugais	`pt`
Hébreu	`he`	Roumain	`ro`
Russe	`ru`	Espagnol	`es`
Suédois	`sv`	Thaï	`th`
Turc	`tr`

Changements de forfait (mise à niveau/rétrogradation)

Les clients peuvent passer à un forfait supérieur ou inférieur depuis le portail entre des produits appartenant à la même Collection de produits.

Pour permettre aux clients ayant déjà un abonnement de changer de forfait, ajoutez vos produits d’abonnement à une collection de produits et activez Autoriser les mises à jour d’abonnement. Les clients pourront alors passer d’un forfait à l’autre dans cette collection depuis le portail.

Actions disponibles

Action	Description	Disponible lorsque
Mise à niveau	Passer à un forfait de niveau supérieur dans la même collection	Autoriser les mises à jour d’abonnement est activé
Rétrogradation	Passer à un forfait de niveau inférieur dans la même collection	Autoriser les mises à jour d’abonnement est activé

Fonctionnement des changements de forfait

Le client clique sur Changer de forfait sur la page de détails de l’abonnement.
Le portail répertorie les autres forfaits de la collection de produits.
Le client sélectionne un forfait. Un panneau Confirmer le changement de forfait affiche le forfait actuel et le forfait mis à jour, le détail des lignes (un crédit pour l’ancien forfait et un débit pour le nouveau), les taxes et le montant dû maintenant. Le client peut également saisir un code de réduction ici.
Le client confirme avec le bouton Payer, qui affiche le montant dû.
Dodo Payments calcule le prorata et perçoit le montant, soit avec le moyen de paiement enregistré, soit sur une page de paiement hébergée si vous encaissez les paiements liés au changement de forfait par lien de paiement (voir Encaisser les paiements liés au changement de forfait par lien de paiement).
L’abonnement passe au nouveau forfait. Le fait que cela se produise immédiatement ou uniquement après la réussite du paiement dépend de votre gestion des échecs de paiement. Un changement de forfait payé par lien de paiement attend toujours le paiement.

Page des détails de l'abonnement avec les boutons Change Plan, Pause Subscription et Cancel Subscription

Panneau Confirm Plan Change affichant le forfait actuel et le forfait mis à jour, le détail des lignes, la saisie du code promotionnel et le bouton Pay

Les changements de forfait ne fonctionnent qu’entre des produits de la même collection, et le produit cible doit être un produit d’abonnement ou basé sur l’utilisation. Les produits ponctuels sont refusés.

Collecte des paiements liés aux changements de forfait par payment link

Par défaut, un changement de forfait immédiat débite le moyen de paiement enregistré du client. Lorsque Encaisser les paiements liés au changement de forfait par lien de paiement est activé, le portail ouvre à la place une page de paiement Dodo Payments hébergée dans un nouvel onglet, où le client paie. Cela s’applique aux mises à niveau et rétrogradations qui entraînent un débit.

Page Settings → Subscriptions avec l'option Collect Plan Change Payments by Payment Link activée et son infobulle expliquant le comportement

Page Dodo Checkout hébergée provenant d'un autre exemple, où le client paie pour un changement de forfait

L’abonnement reste sur son forfait actuel jusqu’à la réussite du paiement sur la page de paiement. Un paiement échoué ou abandonné laisse l’abonnement inchangé, et le client peut réessayer dans la même session de paiement. Les rétrogradations planifiées (effective_at: next_billing_date) ne passent pas par le paiement ; elles s’appliquent à la prochaine date de facturation, comme d’habitude.

Ce paramètre s’applique uniquement aux changements de forfait immédiats. Tant qu’un lien de paiement lié à un changement de forfait n’est ni payé ni expiré, le portail rejette toute nouvelle demande de changement de forfait pour cet abonnement.

Plan Change via Payment Link (API)

Comment demander un payment link avec collect_via_payment_link et gérer la réponse.

Contrôles de l’entreprise

Configurez les actions que les clients peuvent effectuer sur leurs abonnements sous Paramètres → Abonnements :

Autoriser les mises à jour d’abonnement : permet aux clients de passer à un forfait supérieur ou inférieur. Désactivé par défaut.
Autoriser l’annulation immédiate : permet aux clients de mettre fin à leur abonnement et de perdre immédiatement l’accès. Activé par défaut.
Autoriser l’annulation à la prochaine date de facturation : permet aux clients d’annuler à la fin de la période qu’ils ont payée. Activé par défaut.
Autoriser la mise en pause de l’abonnement : permet aux clients de mettre en pause et de reprendre eux-mêmes leurs abonnements. Désactivé par défaut.
Encaisser les paiements liés au changement de forfait par lien de paiement : redirige les clients vers une page de paiement pour régler un changement de forfait immédiat, au lieu de débiter leur moyen de paiement enregistré. Désactivé par défaut.

Product Collections

Configurez les collections de produits et les parcours de mise à niveau et de rétrogradation.

Détails de l’abonnement

Gérer l’abonnement d’un abonnement actif ouvre sa page de détails, qui affiche :

Détails du forfait : le nom de l’abonnement, le prix, la date de renouvellement et la période de validité.
Moyen de paiement : le moyen de paiement associé à l’abonnement, avec un bouton Modifier.
Informations de facturation : le nom, l’e-mail, le numéro de téléphone et l’adresse de facturation, avec un bouton Modifier pour le nom et l’adresse de facturation.
Historique de facturation : un tableau de tous les paiements de cet abonnement.
Mettre l’abonnement en pause : affiché lorsque vous autorisez la mise en pause en libre-service.
Annuler l’abonnement : ouvre la boîte de dialogue d’annulation.

Annulation d’un abonnement

Les clients annulent depuis la page de détails de l’abonnement. Annuler l’abonnement ouvre une boîte de dialogue proposant deux options :

Annuler à la prochaine date de facturation : l’abonnement reste actif jusqu’à la fin de la période de facturation actuelle, puis est annulé.
Annuler maintenant : l’abonnement est annulé immédiatement.

Deux paramètres sous Paramètres → Abonnements contrôlent séparément ces options : Autoriser l’annulation immédiate et Autoriser l’annulation à la prochaine date de facturation. Les deux sont activés par défaut. Désactiver l’un d’eux supprime uniquement l’option correspondante, ce qui vous permet de proposer l’une sans l’autre. Lorsqu’ils sont tous deux désactivés, Annuler l’abonnement est désactivé et son infobulle demande au client de vous contacter. Un client dont l’annulation est déjà planifiée voit Révoquer l’annulation, qui lui permet de rester, ainsi que Annuler immédiatement, qui correspond à la même action qu’Annuler maintenant. Ces paramètres n’affectent pas les annulations que vous effectuez vous-même.

Boîte de dialogue d'annulation d'un abonnement proposant l'annulation à la prochaine date de facturation ou l'annulation immédiate

Motifs d’annulation

Avant de confirmer, le client doit répondre à Pourquoi annulez-vous ? en choisissant une raison dans une liste fixe. Il peut également ajouter un commentaire facultatif de 500 caractères maximum sous Commentaires supplémentaires. Dodo Payments stocke ces deux informations sur l’abonnement et les renvoie dans les payloads de webhook et l’API, afin que vous puissiez analyser les raisons des départs et adapter vos messages de fidélisation.

Fenêtre d'annulation avec la liste déroulante « Pourquoi annulez-vous ? » affichant des motifs tels que Trop cher, Fonctionnalités manquantes et Autre

Valeur	Libellé affiché au client
`too_expensive`	Trop cher
`missing_features`	Fonctionnalités manquantes
`switched_service`	Passage à un autre service
`unused`	Utilisation insuffisante
`customer_service`	Service client médiocre
`low_quality`	Qualité insuffisante
`too_complex`	Trop complexe
`other`	Autre

La raison est enregistrée dans le champ cancellation_feedback de l’abonnement, et le commentaire dans cancellation_comment.

// `client` is a DodoPayments client, created as in the Integration Guide.
// Read the captured feedback after a customer cancels.
const subscription = await client.subscriptions.retrieve('sub_123');
console.log(subscription.cancellation_feedback); // e.g., "too_expensive"
console.log(subscription.cancellation_comment);  // e.g., "Switching to a competitor"

Les deux champs figurent également dans le payload de webhook subscription.cancelled. Pour les définir vous-même, transmettez-les à PATCH /subscriptions/{subscription_id} lorsque vous annulez ou planifiez une annulation via l’API.

Utilisez cancellation_feedback avec Subscription Dunning pour personnaliser les e-mails de fidélisation. Par exemple, envoyez un code de réduction aux clients ayant choisi too_expensive et une enquête de satisfaction à ceux ayant choisi missing_features.

Mise en pause d’un abonnement

La mise en pause offre aux clients une option entre conserver un abonnement et l’annuler. Un abonnement en pause cesse d’être facturé, mais conserve son forfait et son historique ; le client peut donc le reprendre plus tard au lieu de souscrire à nouveau. Les clients ouvrent la boîte de dialogue Mettre votre abonnement en pause depuis la page de détails de l’abonnement. Cette boîte affiche le forfait actuel, avertit que l’accès prend fin immédiatement et explique comment les dates de facturation se décalent. Le client confirme avec Mettre l’abonnement en pause.

La boîte de dialogue indique au client ce qui va se passer, et le système se comporte comme suit :

L’accès s’arrête immédiatement. Les fonctionnalités, téléchargements et clés de licence inclus dans l’abonnement cessent de fonctionner jusqu’à la reprise de l’abonnement.
La pause n’a pas de date de fin. L’abonnement reste en pause jusqu’à ce que le client le reprenne.
Aucun temps payé n’est perdu. La prochaine date de facturation et la date de renouvellement sont toutes deux repoussées de la durée de la pause.

La reprise suit le même parcours et est confirmée avec Reprendre l’abonnement. L’abonnement revient à active et l’accès est rétabli.

Le paramètre Autoriser la mise en pause de l’abonnement sous Paramètres → Abonnements contrôle la mise en pause en libre-service et est désactivé par défaut. Lorsqu’il est désactivé, les clients ne peuvent pas commencer une nouvelle pause, mais ils peuvent toujours reprendre une pause qu’ils ont eux-mêmes commencée. Les pauses que vous démarrez depuis le tableau de bord ne sont pas concernées.

How Pausing Works

Comportement complet de la mise en pause, y compris les effets sur la facturation, le règlement de l’utilisation et les webhooks.

Mise à jour des modes de paiement

Les clients modifient le moyen de paiement d’un abonnement avec Modifier, à côté du moyen de paiement, sur la page de détails de l’abonnement. C’est également ainsi qu’un client réactive un abonnement suspendu après un échec de paiement.

Réactivation des abonnements suspendus

Un abonnement passe à on_hold lorsqu’un paiement échoue. Le portail affiche Votre abonnement est actuellement suspendu et demande au client de mettre à jour son moyen de paiement. Lorsque le client le fait, Dodo Payments :

Crée un débit correspondant aux sommes restant dues
Génère une facture pour ce débit
Encaisse le paiement avec le nouveau moyen de paiement
Réactive l’abonnement à active lorsque le paiement réussit

Un abonnement à l’état on_hold ne se renouvelle pas. Le client doit mettre à jour son moyen de paiement pour régler les sommes dues et le réactiver.

Lorsque les sommes dues pour un abonnement on_hold sont payées, l’abonnement redevient active.

Réactivation des abonnements pendant une période de grâce

Si vous définissez une période de grâce, un renouvellement échoué fait passer l’abonnement à past_due au lieu de on_hold. Le client conserve l’accès jusqu’à la date limite. La récupération fonctionne de la même manière : le client met à jour le moyen de paiement et l’abonnement revient à active. S’il ne fait rien, à la date limite l’abonnement passe à on_hold ou cancelled, selon votre configuration, et l’accès prend fin.

Parcours de mise à jour du mode de paiement

Access Subscription Details

Cliquez sur Gérer l’abonnement pour l’abonnement depuis la vue d’ensemble du portail.

Click Edit on Payment Method

Cliquez sur Modifier à côté du moyen de paiement.

Select or Add Payment Method

Choisissez un moyen de paiement enregistré, ou cliquez sur Ajouter un moyen de paiement et saisissez les nouvelles informations.

Confirm Changes

Confirmez la mise à jour. Pour un abonnement on_hold, cela crée un débit correspondant aux sommes restant dues.

Complete Payment (If On Hold)

Si l’abonnement est suspendu, le client est redirigé pour régler les sommes restant dues. Lorsque le paiement réussit, l’abonnement est réactivé.

Confirmation

Le portail confirme que le moyen de paiement a été mis à jour et, pour un abonnement suspendu, qu’il est de nouveau actif.

Exemples d’intégration

Pour envoyer un client de votre application vers le portail, créez une session de portail sur votre serveur et redirigez le client vers link renvoyé. Le lien est valable 24 heures.

// Server: `client` is a DodoPayments client, created as in the Integration Guide.
const session = await client.customers.customerPortal.create('cus_123', {
  return_url: 'https://yourapp.com/account', // optional: shown as a back link in the portal
});

// Send session.link to the browser, then redirect the customer:
// window.location.href = session.link;

Pour que Dodo Payments envoie également le lien au client par e-mail, transmettez send_email: true.

Customer Portal unifié

En plus du portail de votre entreprise, Dodo Payments gère un Customer Portal unifié à l’adresse customer.dodopayments.com. Les clients peuvent y consulter et gérer leurs achats et abonnements auprès de toutes les entreprises qui vendent via Dodo Payments.

Fonctionnalités du portail unifié

Visibilité inter-entreprises : consultez les achats et abonnements de chaque marchand Dodo Payments au même endroit.
Gestion centralisée : gérez les abonnements auprès de différentes entreprises depuis un seul site.
Historique de facturation unifié : accédez aux factures et à l’historique des paiements de tous les achats.
Connexion unique : connectez-vous une seule fois avec une adresse e-mail pour accéder aux achats de tous les marchands Dodo Payments.

Le Customer Portal unifié fonctionne conjointement avec le portail de votre entreprise. Les clients peuvent utiliser l’un ou l’autre.

Résolution des problèmes

Lien expiré : générez un nouveau lien dynamique et envoyez-le au client.
E-mail non reconnu : demandez au client d’utiliser l’adresse e-mail associée à son achat. Aucun e-mail de connexion n’est envoyé pour une adresse qui n’appartient pas à un client de votre entreprise.
Abonnement suspendu : le client met à jour son moyen de paiement dans le portail. Dodo Payments encaisse les sommes restant dues et réactive l’abonnement lorsque le paiement réussit.
Échec de la mise à jour du moyen de paiement : si le paiement échoue lors de la mise à jour d’un abonnement on_hold, l’abonnement reste suspendu. Le client peut réessayer avec un autre moyen de paiement.

Design & Theme Customization

Personnalisez le portail avec des thèmes, une typographie et des couleurs prédéfinis, ainsi qu’un aperçu en direct, depuis la page Design.

Create Portal Session (API)

Subscriptions

​Qu’est-ce que le Customer Portal ?

​Avantages clés

​Méthodes d’accès

​Lien statique (accès par e-mail)

​Lien dynamique (lien magique)

​Fonctionnalités du portail

Active Subscriptions

Payment Methods

Billing History

Billing Information

​Vue d’ensemble du portail

​Modes de paiement et historique de facturation

​Prise en charge des langues

​Fonctionnement de la sélection de la langue

​Langues prises en charge

​Changements de forfait (mise à niveau/rétrogradation)

​Actions disponibles

​Fonctionnement des changements de forfait

​Collecte des paiements liés aux changements de forfait par payment link

Plan Change via Payment Link (API)

​Contrôles de l’entreprise

Product Collections

​Détails de l’abonnement

​Annulation d’un abonnement

​Motifs d’annulation

​Mise en pause d’un abonnement

How Pausing Works

​Mise à jour des modes de paiement

​Réactivation des abonnements suspendus

​Réactivation des abonnements pendant une période de grâce

​Parcours de mise à jour du mode de paiement

​Exemples d’intégration

​Customer Portal unifié

​Fonctionnalités du portail unifié

​Résolution des problèmes

Design & Theme Customization

Qu’est-ce que le Customer Portal ?

Avantages clés

Méthodes d’accès

Lien statique (accès par e-mail)

Lien dynamique (lien magique)

Fonctionnalités du portail

Vue d’ensemble du portail

Modes de paiement et historique de facturation

Prise en charge des langues

Fonctionnement de la sélection de la langue

Langues prises en charge

Changements de forfait (mise à niveau/rétrogradation)

Actions disponibles

Fonctionnement des changements de forfait

Collecte des paiements liés aux changements de forfait par payment link

Contrôles de l’entreprise

Détails de l’abonnement

Annulation d’un abonnement

Motifs d’annulation

Mise en pause d’un abonnement

Mise à jour des modes de paiement

Réactivation des abonnements suspendus

Réactivation des abonnements pendant une période de grâce

Parcours de mise à jour du mode de paiement

Exemples d’intégration

Customer Portal unifié

Fonctionnalités du portail unifié

Résolution des problèmes