React Native SDK-Integration
Das Dodo Payments React Native SDK ermöglicht es Ihnen, sichere Zahlungserlebnisse in Ihren nativen Android- und iOS-Apps zu erstellen. Unser SDK bietet anpassbare UI-Komponenten und Bildschirme zur Erfassung von Zahlungsdetails.- 📦 Installieren Sie unser SDK von NPM
- 📚 Sehen Sie sich unser Demo-Repository für vollständige Implementierungsbeispiele an
- 🎥 Sehen Sie sich unser Demo-Video an, um das Dodo Payments SDK in Aktion zu sehen
Funktionen
Simplified Security
Sammeln Sie sensible Zahlungsdaten sicher, während Sie weiterhin PCI-konform bleiben
Multiple Payment Methods
Akzeptieren Sie verschiedene Zahlungsmethoden, um Ihre globale Reichweite auszubauen
Native UI
Native Bildschirme und Elemente für Android und iOS
Derzeit werden Apple Pay, Google Pay, Cash App und UPI im React Native SDK nicht unterstützt. Wir arbeiten aktiv daran, diese Zahlungsmethoden in zukünftigen Releases zu integrieren.
Installation
Install the SDK
Installieren Sie das Dodo Payments SDK mit dem von Ihnen bevorzugten Paketmanager:
- npm
- yarn
Clientseitige Einrichtung
Get Publishable Key
Rufen Sie Ihren veröffentlichbaren Schlüssel im Dodo Payments Dashboard ab. (Unterscheidet sich für Test- und Live-Modus)
https://app.dodopayments.com/developer/others
Setup Payment Provider
Binden Sie Ihre App mit dem
DodoPaymentProvider ein:App.tsx
Sie müssen API-Schlüssel aus Ihrem Dodo Payments Dashboard generieren. Siehe unseren API Integration Tutorial für detaillierte Anleitungen.
Create payment utility function
Erstellen Sie eine Hilfsfunktion, um Zahlungsparameter von Ihrer Backend-API abzurufen:
utils/fetchPaymentParams.ts
Diese Funktion setzt voraus, dass Sie einen Backend-API-Endpunkt haben, der Payment Intents erstellt und ein Client-Geheimnis zurückgibt. Stellen Sie sicher, dass Ihr Backend korrekt konfiguriert ist, um Zahlungen zu erstellen. Siehe unser API Integration Tutorial für Beispiele zur Backend-Einrichtung.
Implement the payment screen
Erstellen Sie Ihren Zahlungsbildschirm mit dem
useCheckout-Hook. Hier ist eine vollständige Implementierung:PaymentScreen.tsx
Für vollständige Beispiele mit Styling, Fehlerbehandlung und Anpassungsoptionen schauen Sie sich unsere Demo-Repositories an:
Konfigurationsoptionen
Sitzungsparameter
Das Client-Geheimnis aus Ihrem Payment Intent, das über die One-Time-Payment- oder Subscription-API erhalten wurde.
Der Modus der Zahlungssitzung (Test oder Live).
Anpassungsoptionen für das Erscheinungsbild des Zahlungsformulars
Thema-Modus:
'light' oder 'dark'Anpassung des Erscheinungsbilds
Sie können den React Native Unified Checkout an das Design Ihrer App anpassen, indem Sie Farben, Schriftarten und mehr über den Erscheinungsparameter ändern, wenn SieinitPaymentSession() aufrufen.
Farbanpassung
Jede Farb-kategorie bestimmt die Farbe eines oder mehrerer Komponenten in der Benutzeroberfläche. Beispielsweise definiertprimary die Farbe des Bezahlen-Buttons.
| Farbkategorie | Verwendung |
|---|---|
primary | Primärfarbe für den Bezahlen-Button und ausgewählte Elemente |
background | Hintergrundfarbe der Zahlungsseite |
componentBackground | Hintergrundfarbe für Eingabefelder, Tabs und andere Komponenten |
componentBorder | Externe Rahmenfarbe für Eingabefelder, Tabs und andere Komponenten |
componentDivider | Interne Rahmenfarbe (gemeinsame Rahmen) für Komponenten |
primaryText | Textfarbe für Kopfzeilen |
secondaryText | Beschriftungsfarbe für Eingabefelder |
componentText | Textfarbe für Eingaben (z. B. Kartennummer, Postleitzahl) |
placeholderText | Platzhalterfarbe für Eingabefelder |
icon | Farbe für Symbole (z. B. Schließen-Button) |
error | Farbe für Fehlermeldungen und destruktive Aktionen |
Formanpassung
Sie können den Randradius, die Randbreite und den Schatten, die in der gesamten Zahlungsoberfläche verwendet werden, anpassen:Komponenten-spezifische Anpassung
Sie können spezifische UI-Komponenten wie die primäre Schaltfläche (Pay-Button) anpassen. Diese Einstellungen haben Vorrang vor den globalen Erscheinungseinstellungen:Fehlerbehandlung
Behandeln Sie verschiedene Zahlungszustände in Ihrer Checkout-Funktion:Common Error Scenarios
Common Error Scenarios
- Probleme mit der Netzwerkverbindung: Sorgen Sie für eine stabile Internetverbindung
- Ungültiges Client-Geheimnis: Überprüfen Sie, ob das Backend gültige Payment Intents erzeugt
- Fehlende Peer-Abhängigkeiten: Installieren Sie alle erforderlichen Abhängigkeiten
- Plattformspezifische Einrichtung: Führen Sie die iOS- und Android-Konfigurationsschritte vollständig durch
- API-Fehler: Prüfen Sie unsere Fehlercode-Referenz für detaillierte Fehlerbehandlung
Debugging Tips
Debugging Tips
- Aktivieren Sie das Debug-Logging in der Entwicklung
- Überprüfen Sie Netzwerkaufrufe zu Ihrem Backend
- Stellen Sie sicher, dass API-Schlüssel korrekt konfiguriert sind
- Testen Sie sowohl auf iOS als auch auf Android
- Lesen Sie unsere Technischen FAQs für gängige Probleme
- Verwenden Sie Test- vs. Live-Modus angemessen