React Native SDK Integration
Dodo Payments React Native SDK gör det möjligt för dig att bygga säkra betalningsupplevelser i dina inhemska Android- och iOS-appar. Vår SDK erbjuder anpassningsbara UI-komponenter och skärmar för att samla in betalningsuppgifter.- 📦 Installera vår SDK från NPM
- 📚 Se vårt demo-repo för kompletta implementations exempel
- 🎥 Titta på vår demovideo för att se Dodo Payments SDK i aktion
Funktioner
Simplified Security
Samla in känslig betalningsdata säkert samtidigt som du förblir PCI-kompatibel
Multiple Payment Methods
Acceptera olika betalningsmetoder för att utöka den globala räckvidden
Native UI
Inbyggda skärmar och element för Android och iOS
För närvarande stöds inte Apple Pay, Google Pay, Cash App och UPI i React Native SDK. Vi arbetar aktivt för att lägga till stöd för dessa betalningsmetoder i framtida versioner.
Installation
1
Install the SDK
Installera Dodo Payments SDK med din föredragna pakethanterare:
- npm
- yarn
2
Platform-specific setup
- iOS
- Android
Kör pod install i din iOS-mapp:
Klientsideinstallation
1
Get Publishable Key
Hämta din publicerbara nyckel från Dodo Payments-instrumentpanelen. (Olika för test- och live-lägen)
https://app.dodopayments.com/developer/others
2
Setup Payment Provider
Omslut din app med
DodoPaymentProvider:App.tsx
Du måste skapa API-nycklar från din Dodo Payments-instrumentpanel. Se vår guide för API-nyckelgenerering för detaljerade instruktioner.
3
Create payment utility function
Skapa en hjälpfunktion för att hämta betalningsparametrar från din backend-API:
utils/fetchPaymentParams.ts
Den här funktionen förutsätter att du har en backend-API-endpoint som skapar betalningsavsikter och returnerar ett klientsecret. Säkerställ att din backend är korrekt konfigurerad för att hantera betalningsskapande. Se vår API-integrationsguide för exempel på backendinställningar.
4
Implement the payment screen
Skapa din betalningsskärm med hjälp av
useCheckout-hooken. Här är en komplett implementation:PaymentScreen.tsx
För fullständiga exempel med styling, felhantering och anpassningsalternativ, kolla in våra demoförråd:
Konfigurationsalternativ
Sessionsparametrar
Klientsecreten från din betalningsavsikt, hämtad från One time payment- eller abonnemangs-API:et.
Läget för betalningssessionen (test eller live).
Anpassningsalternativ för betalningssidan utseende
Temaläge:
'light' eller 'dark'Anpassning av utseende
Du kan anpassa React Native Unified Checkout så att det matchar din apps design genom att ändra färger, typsnitt och mer via appearance-parametern när du kallarinitPaymentSession().
Färganpassning
Varje färgkategori bestämmer färgen för en eller flera komponenter i användargränssnittet. Till exempel definierarprimary färgen för Betalknappen.
Exempelkonfiguration med stöd för ljus och mörk läge:
Formanpassning
Du kan anpassa kantens radie, kantens bredd och skugga som används genom hela betalningsgränssnittet:Komponent-specifik anpassning
Du kan anpassa specifika UI-komponenter som primärknappen (Betala-knappen). Dessa inställningar har företräde framför de globala utseendeinställningarna:Felhantering
Hantera olika betalningstillstånd i din kassa-funktion:Common Error Scenarios
Common Error Scenarios
- Problem med nätverksanslutning: Säkerställ stabil internetanslutning
- Ogiltigt klientsecret: Kontrollera att backend genererar giltiga betalningsavsikter
- Saknade peer-beroenden: Installera alla nödvändiga beroenden
- Plattformspecifik konfiguration: Slutför inställningsstegen för iOS och Android
- API-fel: Kolla vår Error Codes Reference för detaljerad felhantering
Debugging Tips
Debugging Tips
- Aktivera felsökningsloggning under utveckling
- Kontrollera nätverksförfrågningar till din backend
- Kontrollera att API-nycklar är korrekt konfigurerade
- Testa på både iOS- och Android-plattformar
- Gå igenom våra Tekniska vanliga frågor för vanliga problem
- Använd Test- vs Live-läge lämpligt