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

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.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.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ètrecustomization.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.

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