Intégration du SDK React Native
Le SDK React Native de Dodo Payments vous permet de créer des expériences de paiement sécurisées dans vos applications Android et iOS natives. Notre SDK fournit des composants et des écrans UI personnalisables pour la collecte des détails de paiement.- 📦 Installez notre SDK depuis NPM
- 📚 Consultez notre dépôt de démonstration pour des exemples d’implémentation complets
- 🎥 Regardez notre vidéo de démonstration pour voir le SDK Dodo Payments en action
Fonctionnalités
Sécurité simplifiée
Collectez des données de paiement sensibles en toute sécurité tout en restant conforme à la norme PCI
Méthodes de paiement multiples
Acceptez diverses méthodes de paiement pour étendre votre portée mondiale
UI native
Écrans et éléments natifs pour Android et iOS
Actuellement, Apple Pay, Google Pay, Cash App et UPI ne sont pas pris en charge dans le SDK React Native. Nous travaillons activement à ajouter le support de ces méthodes de paiement dans les futures versions.
Installation
1
Installer le SDK
Installez le SDK Dodo Payments en utilisant votre gestionnaire de paquets préféré :
- npm
- yarn
2
Configuration spécifique à la plateforme
- iOS
- Android
Exécutez pod install dans votre dossier iOS :
Configuration côté client
1
Obtenir la clé publiable
Obtenez votre clé publiable depuis le tableau de bord Dodo Payments. (Distinct pour les modes test et live)
https://app.dodopayments.com/developer/others
2
Configurer le fournisseur de paiement
Enveloppez votre application avec le
DodoPaymentProvider :App.tsx
Vous devrez générer des clés API depuis votre tableau de bord Dodo Payments. Consultez notre guide de génération de clés API pour des instructions détaillées.
3
Créer une fonction utilitaire de paiement
Créez une fonction utilitaire pour récupérer les paramètres de paiement depuis votre API backend :
utils/fetchPaymentParams.ts
Cette fonction suppose que vous avez un point de terminaison API backend qui crée des intentions de paiement et renvoie un secret client. Assurez-vous que votre backend est correctement configuré pour gérer la création de paiements. Consultez notre tutoriel d’intégration API pour des exemples de configuration backend.
4
Implémenter l'écran de paiement
Créez votre écran de paiement en utilisant le
useCheckout hook. Voici une implémentation complète :PaymentScreen.tsx
Pour des exemples complets avec style, gestion des erreurs et options de personnalisation, consultez nos dépôts de démonstration :
Options de configuration
Paramètres de session
Le secret client de votre intention de paiement, obtenu depuis l’API de paiement unique ou d’abonnement.
Le mode de la session de paiement (test ou live).
Options de personnalisation pour l’apparence de la feuille de paiement
Mode de thème :
'light' ou 'dark'Personnalisation de l’apparence
Vous pouvez personnaliser le Checkout Unifié React Native pour correspondre au design de votre application en modifiant les couleurs, les polices, et plus encore via le paramètre d’apparence lors de l’appel àinitPaymentSession().
Personnalisation des couleurs
Chaque catégorie de couleur détermine la couleur d’un ou plusieurs composants de l’UI. Par exemple,primary définit la couleur du bouton de paiement.
| Catégorie de couleur | Utilisation |
|---|---|
primary | Couleur principale pour le bouton de paiement et les éléments sélectionnés |
background | Couleur de fond de la page de paiement |
componentBackground | Couleur de fond pour les entrées, les onglets et d’autres composants |
componentBorder | Couleur de bordure externe pour les entrées, les onglets et d’autres composants |
componentDivider | Couleur de bordure interne (bords partagés) pour les composants |
primaryText | Couleur du texte d’en-tête |
secondaryText | Couleur du texte des étiquettes pour les champs de saisie |
componentText | Couleur du texte d’entrée (par exemple, numéro de carte, code postal) |
placeholderText | Couleur du texte d’espace réservé pour les champs de saisie |
icon | Couleur pour les icônes (par exemple, bouton de fermeture) |
error | Couleur pour les messages d’erreur et les actions destructrices |
Personnalisation de la forme
Vous pouvez personnaliser le rayon de bordure, la largeur de bordure et l’ombre utilisées dans toute l’interface de paiement :Personnalisation spécifique aux composants
Vous pouvez personnaliser des composants UI spécifiques comme le bouton principal (bouton de paiement). Ces paramètres ont la priorité sur les paramètres d’apparence globaux :Gestion des erreurs
Gérez différents états de paiement dans votre fonction de paiement :Scénarios d'erreur courants
Scénarios d'erreur courants
- Problèmes de connectivité réseau : Assurez-vous d’une connexion Internet stable
- Secret client invalide : Vérifiez que le backend génère des intentions de paiement valides
- Dépendances manquantes : Installez toutes les dépendances requises
- Configuration spécifique à la plateforme : Complétez les étapes de configuration iOS et Android
- Erreurs API : Consultez notre Référence des codes d’erreur pour une gestion des erreurs détaillée
Conseils de débogage
Conseils de débogage
- Activez la journalisation de débogage en développement
- Vérifiez les requêtes réseau vers votre backend
- Vérifiez que les clés API sont correctement configurées
- Testez sur les plateformes iOS et Android
- Consultez nos FAQ techniques pour des problèmes courants
- Utilisez Mode test vs Mode live de manière appropriée