Zum Hauptinhalt springen

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

1

Install the SDK

Installieren Sie das Dodo Payments SDK mit dem von Ihnen bevorzugten Paketmanager:
2

Platform-specific setup

Führen Sie pod install in Ihrem iOS-Ordner aus:

Clientseitige Einrichtung

1

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
2

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.
3

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.
4

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

clientSecret
string
erforderlich
Das Client-Geheimnis aus Ihrem Payment Intent, das über die One-Time-Payment- oder Subscription-API erhalten wurde.
mode
string
erforderlich
Der Modus der Zahlungssitzung (Test oder Live).
configuration.appearance
object
Anpassungsoptionen für das Erscheinungsbild des Zahlungsformulars
configuration.appearance.themes
string
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 Sie initPaymentSession() aufrufen.

Farbanpassung

Jede Farb-kategorie bestimmt die Farbe eines oder mehrerer Komponenten in der Benutzeroberfläche. Beispielsweise definiert primary die Farbe des Bezahlen-Buttons. Beispielkonfiguration mit Unterstützung für hellen und dunklen Modus:

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:
Um diese Anpassungen anzuwenden, fügen Sie sie in Ihre Zahlungs-Sitzungskonfiguration ein:

Fehlerbehandlung

Behandeln Sie verschiedene Zahlungszustände in Ihrer Checkout-Funktion:
  • 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
  • Aktivieren Sie das Debug-Logging in der Entwicklungsphase
  • Überprüfen Sie die Netzwerk-Anfragen an Ihr Backend
  • Stellen Sie sicher, dass die API-Schlüssel korrekt konfiguriert sind
  • Testen Sie auf iOS- und Android-Plattformen
  • Überprüfen Sie unsere Technischen FAQs für häufige Probleme
  • Verwenden Sie den Test- vs. Livemodus angemessen

Test-Zahlungsmethoden

Verwenden Sie Testkartennummern in der Entwicklung, um Ihre Integration zu überprüfen, ohne echte Zahlungen abzuwickeln. Erfahren Sie mehr über unseren Testprozess und verfügbare Testumgebungen.
Zuletzt geändert am 28. Mai 2026