Prérequis
Pour intégrer l’API Dodo Payments, vous aurez besoin de :- Un compte marchand Dodo Payments
- Identifiants API (clé API et clé secrète de webhook) depuis le tableau de bord
Configuration du tableau de bord
- Accédez au Tableau de bord Dodo Payments
- Créez un produit (paiement unique ou abonnement)
-
Générez votre clé API :
- Allez dans Développeur > API
- Guide détaillé
- Copiez la clé API dans l’environnement nommé DODO_PAYMENTS_API_KEY
-
Configurez les webhooks :
- Allez dans Développeur > Webhooks
- Créez une URL de webhook pour les notifications de paiement
- Copiez la clé secrète de webhook dans l’environnement
Intégration
Liens de paiement
Choisissez le chemin d’intégration qui correspond à votre cas d’utilisation :- Sessions de paiement (recommandé) : Idéal pour la plupart des intégrations. Créez une session sur votre serveur et redirigez les clients vers un paiement sécurisé, hébergé.
- Paiement en superposition : Utilisez-le lorsque vous avez besoin d’une expérience en page qui ouvre le paiement comme une superposition modale sur votre site.
- Paiement en ligne : Intégrez le paiement directement dans la mise en page de votre page pour des expériences de paiement entièrement intégrées et de marque.
- Liens de paiement statiques : URL partageables instantanément sans code pour une collecte de paiement rapide.
- Liens de paiement dynamiques : Liens créés par programmation. Cependant, les Sessions de paiement sont recommandées et offrent plus de flexibilité.
1. Sessions de paiement
Utilisez les sessions de paiement pour créer une expérience de paiement sécurisée et hébergée pour les paiements uniques ou les abonnements. Vous créez une session sur votre serveur, puis redirigez le client vers lecheckout_url retourné.
Les sessions de paiement sont valides pendant 24 heures par défaut. Si vous passez
confirm=true, les sessions sont valides pendant 15 minutes et tous les champs requis doivent être fournis.1
Créer une session de paiement
Choisissez votre SDK préféré ou appelez l’API REST.
- Node.js SDK
- Python SDK
- REST API
2
Rediriger le client vers le paiement
Après la création de la session, redirigez vers le
checkout_url pour commencer le flux hébergé.2. Overlay Checkout
Pour une expérience de paiement intégrée sans couture, explorez notre intégration Overlay Checkout qui permet aux clients de finaliser leurs paiements sans quitter votre site web.3. Paiement en ligne
Pour des expériences de paiement entièrement intégrées directement dans votre page, utilisez notre intégration Paiement en ligne. Cela vous permet de créer des résumés de commande personnalisés et d’avoir un contrôle total sur la mise en page du paiement pendant que Dodo Payments gère la collecte des paiements de manière sécurisée.4. Liens de paiement statiques
Les liens de paiement statiques vous permettent d’accepter rapidement des paiements en partageant une simple URL. Vous pouvez personnaliser l’expérience de paiement en passant des paramètres de requête pour pré-remplir les détails du client, contrôler les champs de formulaire et ajouter des métadonnées personnalisées.1
Construisez votre lien de paiement
Commencez par l’URL de base et ajoutez votre ID de produit :
2
Ajoutez des paramètres essentiels
Incluez les paramètres de requête essentiels :
-
Nombre d’articles à acheter.
-
URL vers laquelle rediriger après la finalisation du paiement.
L’URL de redirection inclura les détails du paiement en tant que paramètres de requête, par exemple :
https://example.com/?payment_id=pay_ts2ySpzg07phGeBZqePbH&status=succeeded3
Pré-remplir les informations du client (optionnel)
Ajoutez des champs client ou de facturation en tant que paramètres de requête pour simplifier le paiement.
Champs client pris en charge
Champs client pris en charge
-
Nom complet du client (ignoré si firstName ou lastName est fourni).
-
Prénom du client.
-
Nom de famille du client.
-
Adresse e-mail du client.
-
Pays du client.
-
Adresse de rue.
-
Ville.
-
État ou province.
-
Code postal.
-
true ou false
4
Contrôler les champs de formulaire (optionnel)
Vous pouvez désactiver des champs spécifiques pour les rendre en lecture seule pour le client. Cela est utile lorsque vous avez déjà les détails du client (par exemple, les utilisateurs connectés).
disable… correspondant sur true :- Tableau des drapeaux de désactivation
| Champ | Drapeau de désactivation | Paramètre requis |
|---|---|---|
| Nom complet | disableFullName | fullName |
| Prénom | disableFirstName | firstName |
| Nom de famille | disableLastName | lastName |
disableEmail | email | |
| Pays | disableCountry | country |
| Adresse ligne | disableAddressLine | addressLine |
| Ville | disableCity | city |
| État | disableState | state |
| Code postal | disableZipCode | zipCode |
Définir
showDiscounts=false désactivera et masquera la section des réductions dans le formulaire de paiement. Utilisez cela si vous souhaitez empêcher les clients d’entrer des codes de coupon ou de promotion lors du paiement.5
Ajoutez des contrôles avancés (optionnel)
-
Spécifie la devise de paiement. Par défaut, c’est la devise du pays de facturation.
-
Afficher ou masquer le sélecteur de devise.
-
Montant en cents (pour le prix Pay What You Want uniquement).
-
Champs de métadonnées personnalisées (par exemple,
metadata_orderId=123).
6
Partagez le lien
Envoyez le lien de paiement complété à votre client. Lorsqu’il le visite, tous les paramètres de requête sont collectés et stockés avec un ID de session. L’URL est ensuite simplifiée pour inclure uniquement le paramètre de session (par exemple,
?session=sess_1a2b3c4d). Les informations stockées persistent à travers les actualisations de page et sont accessibles tout au long du processus de paiement.L’expérience de paiement du client est maintenant simplifiée et personnalisée en fonction de vos paramètres.
4. Liens de paiement dynamiques
Créé via un appel API ou notre SDK avec les détails du client. Voici un exemple : Il existe deux API pour créer des liens de paiement dynamiques :- API de lien de paiement unique Référence API
- API de lien de paiement d’abonnement Référence API
Assurez-vous de passer
payment_link = true pour obtenir le lien de paiement - SDK Node.js
- SDK Python
- SDK Go
- Référence API
Après avoir créé le lien de paiement, redirigez vos clients pour qu’ils complètent leur paiement.