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
Simplified Security
Collectez les données de paiement sensibles en toute sécurité tout en restant conforme à la norme PCI
Multiple Payment Methods
Acceptez différents moyens de paiement pour étendre votre portée mondiale
Native UI
É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 à l’ajout de ces moyens de paiement dans de futures versions.
Installation
Install the SDK
Installez le SDK Dodo Payments avec le gestionnaire de paquets de votre choix :
- npm
- yarn
Configuration côté client
Get Publishable Key
Récupérez votre clé publique depuis le tableau de bord Dodo Payments. (Distincte pour les modes test et production)
https://app.dodopayments.com/developer/others
Setup Payment Provider
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.
Create payment utility function
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 disposez d’un point de terminaison API backend qui crée des intents de paiement et renvoie un client secret. 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.
Implement the payment screen
Créez votre écran de paiement en utilisant le hook
useCheckout. 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 client secret de votre intent de paiement, obtenu via l’API de paiement unique ou d’abonnement.
Le mode de la session de paiement (test ou production).
Options de personnalisation pour l’apparence de la feuille de paiement
Mode du thème :
'light' ou 'dark'Personnalisation de l’apparence
Vous pouvez personnaliser l’Unified Checkout React Native pour qu’il corresponde au design de votre application en modifiant les couleurs, les polices, etc. via le paramètre appearance lors de l’appel deinitPaymentSession().
Personnalisation des couleurs
Chaque catégorie de couleur détermine la couleur d’un ou plusieurs composants de l’interface. Par exemple,primary définit la couleur du bouton Payer.
| Catégorie de couleur | Utilisation |
|---|---|
primary | Couleur principale pour le bouton Payer et les éléments sélectionnés |
background | Couleur d’arrière-plan de la page de paiement |
componentBackground | Couleur d’arrière-plan pour les champs, onglets et autres composants |
componentBorder | Couleur de bordure externe pour les champs, onglets et 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 des champs |
componentText | Couleur du texte des champs (par ex., numéro de carte, code postal) |
placeholderText | Couleur du texte des espaces réservés pour les champs |
icon | Couleur des icônes (par ex., bouton de fermeture) |
error | Couleur des messages d’erreur et des 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 :Common Error Scenarios
Common Error Scenarios
- Problèmes de connectivité réseau : Assurez une connexion internet stable
- Client secret invalide : Vérifiez que votre backend génère des intents de paiement valides
- Dépendances manquantes : Installez toutes les dépendances requises
- Configuration spécifique à la plateforme : Finalisez les étapes de configuration iOS et Android
- Erreurs d’API : Consultez notre référence des codes d’erreur pour la gestion détaillée des erreurs
Debugging Tips
Debugging Tips
- Activez la journalisation de débogage en développement
- Vérifiez les requêtes réseau vers votre backend
- Assurez-vous que les clés API sont correctement configurées
- Testez à la fois sur iOS et Android
- Consultez nos FAQ techniques pour les problèmes courants
- Utilisez Mode test vs mode production de manière appropriée