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
Vereinfachte Sicherheit
Erfassen Sie sensible Zahlungsdaten sicher und bleiben Sie PCI-konform
Mehrere Zahlungsmethoden
Akzeptieren Sie verschiedene Zahlungsmethoden, um die globale Reichweite zu erweitern
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 Versionen hinzuzufügen.
Installation
1
SDK installieren
Installieren Sie das Dodo Payments SDK mit Ihrem bevorzugten Paketmanager:
- npm
- yarn
2
Plattformspezifische Einrichtung
- iOS
- Android
Führen Sie pod install in Ihrem iOS-Ordner aus:
Clientseitige Einrichtung
1
Veröffentlichten Schlüssel abrufen
Holen Sie sich Ihren veröffentlichten Schlüssel aus dem Dodo Payments-Dashboard. (Unterscheidet sich für Test- und Live-Modus)
https://app.dodopayments.com/developer/others
2
Zahlungsanbieter einrichten
Wickeln Sie Ihre App mit dem
DodoPaymentProvider:App.tsx
Sie müssen API-Schlüssel aus Ihrem Dodo Payments-Dashboard generieren. Siehe unseren Leitfaden zur API-Schlüsselgenerierung für detaillierte Anweisungen.
3
Zahlungsdienstprogrammfunktion erstellen
Erstellen Sie eine Dienstprogrammfunktion, um Zahlungsparameter von Ihrer Backend-API abzurufen:
utils/fetchPaymentParams.ts
Diese Funktion geht davon aus, dass Sie einen Backend-API-Endpunkt haben, der Zahlungsabsichten erstellt und ein Client-Geheimnis zurückgibt. Stellen Sie sicher, dass Ihr Backend ordnungsgemäß konfiguriert ist, um die Zahlungsabwicklung zu unterstützen. Siehe unser API-Integrations-Tutorial für Beispiele zur Backend-Einrichtung.
4
Zahlungsbildschirm implementieren
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, sehen Sie sich unsere Demo-Repositories an:
Konfigurationsoptionen
Sitzungsparameter
Das Client-Geheimnis aus Ihrer Zahlungsabsicht, das von der Einmalzahlung oder dem Abonnement-API erhalten wurde.
Der Modus der Zahlungssitzung (Test oder Live).
Anpassungsoptionen für das Erscheinungsbild des Zahlungsblatts
Themenmodus:
'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 beim Aufruf voninitPaymentSession() ändern.
Farbanpassung
Jede Farbgruppe bestimmt die Farbe eines oder mehrerer Komponenten in der UI. Zum Beispiel definiertprimary die Farbe des Pay-Buttons.
| Farbgruppe | Verwendung |
|---|---|
primary | Primärfarbe für den Pay-Button und ausgewählte Elemente |
background | Hintergrundfarbe der Zahlungsseite |
componentBackground | Hintergrundfarbe für Eingaben, Tabs und andere Komponenten |
componentBorder | Außenrandfarbe für Eingaben, Tabs und andere Komponenten |
componentDivider | Innenrandfarbe (gemeinsame Ränder) für Komponenten |
primaryText | Header-Textfarbe |
secondaryText | Beschriftungstextfarbe für Eingabefelder |
componentText | Eingabetextfarbe (z. B. Kartennummer, Postleitzahl) |
placeholderText | Platzhaltertextfarbe für Eingabefelder |
icon | Farbe für Icons (z. B. Schaltfläche schließen) |
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:Häufige Fehlerszenarien
Häufige Fehlerszenarien
- Netzwerkverbindungsprobleme: Stellen Sie eine stabile Internetverbindung sicher
- Ungültiges Client-Geheimnis: Überprüfen Sie, ob das Backend gültige Zahlungsabsichten generiert
- Fehlende Peer-Abhängigkeiten: Installieren Sie alle erforderlichen Abhängigkeiten
- Plattformspezifische Einrichtung: Schließen Sie die Konfigurationsschritte für iOS und Android ab
- API-Fehler: Überprüfen Sie unser Fehlercodes-Referenz für detaillierte Fehlerbehandlung
Debugging-Tipps
Debugging-Tipps
- Aktivieren Sie das Debug-Logging in der Entwicklung
- Überprüfen Sie Netzwerk-Anfragen an Ihr Backend
- Überprüfen Sie, ob die API-Schlüssel korrekt konfiguriert sind
- Testen Sie auf sowohl iOS- als auch Android-Plattformen
- Überprüfen Sie unsere Technischen FAQs für häufige Probleme
- Verwenden Sie Test- vs. Live-Modus angemessen