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é) : Meilleur pour la plupart des intégrations. Créez une session sur votre serveur et redirigez les clients vers un paiement sécurisé hébergé.
- Overlay Checkout (intégré) : Utilisez-le lorsque vous avez besoin d’une expérience en page qui intègre le paiement hébergé sur votre site.
- Liens de paiement statiques : URL partageables instantanément sans code pour une collecte rapide des paiements.
- 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. Liens de paiement statiques
Les liens de paiement statiques vous permettent d’accepter rapidement des paiements en partageant une URL simple. 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 du formulaire et ajouter des métadonnées personnalisées.1
Construire votre lien de paiement
Commencez par l’URL de base et ajoutez votre ID de produit :
2
Ajouter 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 du 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 |
| Ligne d’adresse | 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
Ajouter 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
Partager 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 rationalisé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 - Node.js SDK
- Python SDK
- Go SDK
- Référence API
Après avoir créé le lien de paiement, redirigez vos clients pour finaliser leur paiement.