Skip to main content
Page de paiement
Le checkout de Dodo Payments est une page de paiement hébergée conçue pour les produits numériques et les solutions SaaS. Il gère la conversion des devises, le calcul des taxes, les codes de réduction, la collecte de l’adresse et la sélection du mode de paiement. Vous créez une session de checkout via l’API ou le dashboard, puis les clients effectuent le paiement sur une page sécurisée à votre image.

Checkout Sessions API

Créez des sessions de checkout par programmation.

Preview Checkout

Calculez les prix et les taxes avant de créer une session.

Payment Methods

Modes de paiement et configuration pris en charge.

Integration Guide

Guide d’intégration du checkout étape par étape.
Les liens de checkout générés via la Checkout Sessions API ne sont pas réutilisables. Ils expirent après 24 heures, ou après 15 minutes si confirm: true est défini. Générez une nouvelle session pour chaque client et chaque tentative de paiement.

Adaptive Currency

Adaptive Currency permet aux clients de payer dans leur devise locale préférée, ce qui améliore la confiance et les taux de conversion. Lorsqu’elle est activée, les clients voient un sélecteur de devise dans le checkout. Le prix est converti dans la devise choisie selon les taux de change en temps réel. Si la Purchasing Power Parity est activée pour le produit, le prix ajusté selon la PPP est converti à la place du prix de base. Si la Charm Pricing est activée, le montant converti est arrondi pour obtenir une terminaison harmonieuse telle que 49.99.
Sélecteur de devise lors du paiement
Pour activer Adaptive Currency, accédez à Settings → Business et activez l’option.

Adaptive Currency

Devises prises en charge, frais de conversion et gestion des remboursements.

Checkout multilingue

Le checkout prend en charge 22 langues. Les clients peuvent changer de langue directement sur la page, et le texte de l’interface, les libellés et les messages système sont localisés.
Sélecteur de langue dans le checkout

Langues prises en charge

Pour imposer une langue spécifique, définissez customization.force_language lors de la création d’une session de checkout. Consultez la Checkout Sessions API pour plus d’informations.

Calcul automatique des taxes

Les taxes sont calculées automatiquement en fonction du lieu de facturation du client, afin d’assurer la conformité aux exigences relatives à la GST, à la VAT et aux taxes sur les ventes. Les règles fiscales s’appliquent en fonction du pays et de la région du client, le cas échéant. Le montant de la taxe est automatiquement mis à jour lorsque le client change de pays ou modifie son adresse. Le détail final des taxes est clairement affiché avant le paiement.
Le calcul des taxes est entièrement automatisé. Aucune configuration manuelle n’est requise pour les produits numériques et les produits SaaS standard.

Prise en charge du numéro fiscal de l’entreprise

Pour les transactions B2B, le checkout permet aux clients de saisir leur numéro fiscal d’entreprise (par exemple, leur numéro de VAT ou de GST). Une fois saisi, le numéro fiscal est validé en temps réel et les exonérations fiscales ou règles d’autoliquidation applicables sont automatiquement appliquées.
Saisie du numéro fiscal de l’entreprise dans le checkout

Codes de réduction

Les clients peuvent appliquer les codes de réduction ou codes promotionnels que vous avez créés dans le dashboard. La réduction est validée instantanément et le prix mis à jour est affiché. Lorsque la Purchasing Power Parity est activée pour un produit, la réduction s’applique au prix ajusté selon la PPP, et non au prix de base.
Saisie d’un code de réduction dans le checkout
Vous pouvez appliquer au préalable des codes de réduction ou activer le champ de saisie des réductions via l’API :
discount_codes accepte un tableau contenant jusqu’à 20 codes, appliqués dans l’ordre. Le champ singulier discount_code est obsolète, mais continue de fonctionner pour assurer la rétrocompatibilité.

Discount Codes

Créez et gérez des codes de réduction.

Validate Discount by Code

Recherchez et validez des réductions à l’aide de noms de codes.

Collecte intelligente des adresses

Le checkout prend en charge une saisie flexible des adresses afin de trouver un équilibre entre rapidité, précision et couverture mondiale.

Options

Mode d’adresse minimale

Pour maximiser la conversion, activez la collecte minimale des adresses afin de réduire les frictions lors du checkout. Lorsque minimal_address est défini sur true, le checkout collecte uniquement :
  • Pays — toujours requis pour déterminer les taxes
  • Code ZIP/code postal — uniquement dans les régions où il est nécessaire pour calculer les taxes sur les ventes, la VAT ou la GST
Tous les autres champs d’adresse sont ignorés.
Mode d’adresse minimale affichant uniquement les champs du pays et du code ZIP/code postal dans le checkout
La collecte complète de l’adresse est activée par défaut. Activez minimal_address pour les produits numériques et les parcours SaaS qui ne nécessitent pas de détails de facturation complets.

Collecte du numéro de téléphone

Contrôlez l’affichage du champ de numéro de téléphone dans le checkout et indiquez s’il est obligatoire.
require_phone_number: true nécessite allow_phone_number_collection: true. L’API rejette les sessions dans lesquelles la collecte du numéro de téléphone est désactivée alors que le numéro de téléphone est obligatoire.

Champs personnalisés

Collectez des informations supplémentaires auprès des clients pendant le checkout en définissant des champs de formulaire personnalisés. Cette fonctionnalité est utile pour recueillir le nom de l’entreprise, la taille de l’équipe, la source de recommandation ou toute autre donnée spécifique à votre activité.

Types de champs disponibles

Exemple

Les réponses des clients sont automatiquement incluses dans les charges utiles des webhooks (payment.succeeded, subscription.active) et dans les réponses de l’API via le tableau custom_field_responses. Vous pouvez définir jusqu’à 5 champs personnalisés par session de checkout.

Custom Fields Guide

Configuration des champs personnalisés et accès aux réponses.

Acceptation de la politique de confidentialité et des conditions

Pour garantir la transparence juridique et en matière de conformité :
  • Les liens vers la Privacy Policy et les Buyer Terms sont clairement affichés dans le checkout
  • Les clients reconnaissent explicitement ces documents avant de finaliser le paiement
Cela contribue au respect des exigences mondiales en matière de protection des consommateurs et de confidentialité des données, notamment la conformité au RGPD.

Collections de produits

Les collections de produits offrent une expérience de checkout unifiée dans laquelle les clients peuvent consulter et sélectionner plusieurs produits associés (par exemple, les forfaits Starter, Pro et Enterprise) au sein d’un seul checkout. Lorsqu’une collection est utilisée, tous les produits actifs qu’elle contient sont affichés. Le premier produit est présélectionné et les clients peuvent comparer les options avant de faire leur choix.
Lorsque vous utilisez product_collection_id, transmettez un tableau product_cart vide. Les codes de réduction ne peuvent pas être appliqués au préalable lors de la création de la session.

Product Collections

Créez et gérez des collections de produits.

Configuration de la session de checkout

Contrôlez le comportement du checkout à l’aide de la Checkout Sessions API :
Après le paiement, les clients sont redirigés vers votre return_url, auquel des paramètres de requête sont automatiquement ajoutés — notamment payment_id ou subscription_id, status, email et license_key (le cas échéant). Consultez le guide Checkout Sessions pour obtenir la liste complète.

Checkout Sessions API

Référence complète de l’API pour les sessions de checkout.

Checkout Integration Guide

Guide d’intégration du checkout étape par étape.

Personnalisation du thème

Personnalisez l’apparence de la page de checkout pour l’adapter à votre marque à l’aide du paramètre customization.theme_config. Configurez les couleurs, les polices, le rayon des bordures et le texte des boutons pour les modes clair et sombre. Cette section couvre l’API côté serveur, qui utilise des noms de propriétés tels que bg_primary. Un thème défini sur la session s’applique au checkout hébergé, en overlay et inline. L’option themeConfig côté client du Checkout SDK, qui utilise des noms de propriétés tels que bgPrimary, est obsolète. Consultez Overlay Checkout.
Page de checkout avec thème personnalisé

Design & Theme Customization

Configurez visuellement les thèmes depuis le dashboard à l’aide de thèmes prédéfinis, de paramètres typographiques, de couleurs et d’un aperçu en temps réel.

Options de configuration du thème

Configuration des couleurs (mode clair/sombre)

Chaque mode prend en charge les propriétés de couleur suivantes :
Tous les champs de couleur acceptent les formats de couleur CSS standard :
  • Hexadécimal : #fff, #ffffff, #ffffffff
  • RGB/RGBA : rgb(255, 255, 255), rgba(255, 255, 255, 0.5)
  • HSL/HSLA : hsl(120, 100%, 50%), hsla(120, 100%, 50%, 0.5)
  • Couleurs nommées : red, blue, transparent

Exemple

Il n’est pas nécessaire de spécifier toutes les propriétés de couleur. Les propriétés non spécifiées utilisent les valeurs du thème par défaut.
Dernière modification le 26 septembre 2026