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
Förenklad säkerhet
Samla in känsliga betalningsdata på ett säkert sätt och förbli PCI-kompatibel
Flera betalningsmetoder
Acceptera olika betalningsmetoder för att utöka den globala räckvidden
Inhemsk UI
Inhemska 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 med att lägga till stöd för dessa betalningsmetoder i framtida versioner.
Installation
1
Installera SDK
Installera Dodo Payments SDK med din föredragna paketförvaltare:
- npm
- yarn
2
Plattformspecifik installation
- iOS
- Android
Kör pod install i din iOS-mapp:
Klientsideinstallation
1
Hämta publicerbar nyckel
Hämta din publicerbara nyckel från Dodo Payments-instrumentpanelen. (Skiljer sig för både test- och live-lägen)
https://app.dodopayments.com/developer/others
2
Ställ in betalningsleverantör
Omslut din app med
DodoPaymentProvider:App.tsx
Du behöver generera API-nycklar från din Dodo Payments-instrumentpanel. Se vår guide för API-nyckelgenerering för detaljerade instruktioner.
3
Skapa betalningsverktygsfunktion
Skapa en verktygsfunktion för att hämta betalningsparametrar från din backend-API:
utils/fetchPaymentParams.ts
Denna funktion förutsätter att du har en backend-API-slutpunkt som skapar betalningsintentioner och returnerar en klienthemlighet. Se till att din backend är korrekt konfigurerad för att hantera betalningsskapande. Se vår API-integrationshandledning för exempel på backend-installation.
4
Implementera betalningsskärmen
Skapa din betalningsskärm med
useCheckout hook. Här är en komplett implementation:PaymentScreen.tsx
För kompletta exempel med styling, felhantering och anpassningsalternativ, kolla in våra demo-repositories:
Konfigurationsalternativ
Sessionsparametrar
Klienthemligheten från din betalningsintention, erhållen från engångsbetalning eller prenumerations-API.
Läget för betalningssessionen (test eller live).
Anpassningsalternativ för betalningsbladets utseende
Temaläge:
'light' eller 'dark'Anpassning av utseende
Du kan anpassa React Native Unified Checkout för att matcha din apps design genom att modifiera färger, typsnitt och mer genom utseendeparametern när du anroparinitPaymentSession().
Färganpassning
Varje färgkategori bestämmer färgen på en eller flera komponenter i UI. Till exempel definierarprimary färgen på Betala-knappen.
| Färgkategori | Användning |
|---|---|
primary | Primär färg för Betala-knappen och valda objekt |
background | Bakgrundsfärg för betalningssidan |
componentBackground | Bakgrundsfärg för inmatningar, flikar och andra komponenter |
componentBorder | Extern kantfärg för inmatningar, flikar och andra komponenter |
componentDivider | Intern kantfärg (delade kanter) för komponenter |
primaryText | Headertextfärg |
secondaryText | Etiketttextfärg för inmatningsfält |
componentText | Inmatningstextfärg (t.ex. kortnummer, postnummer) |
placeholderText | Platshållartextfärg för inmatningsfält |
icon | Färg för ikoner (t.ex. stängknapp) |
error | Färg för felmeddelanden och destruktiva åtgärder |
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:Vanliga felscenarier
Vanliga felscenarier
- Nätverksanslutningsproblem: Säkerställ stabil internetanslutning
- Ogiltig klienthemlighet: Verifiera att backend genererar giltiga betalningsintentioner
- Saknade beroenden: Installera alla nödvändiga beroenden
- Plattformspecifik installation: Slutför iOS- och Android-konfigurationssteg
- API-fel: Kontrollera vår Felkodsreferens för detaljerad felhantering
Debugging-tips
Debugging-tips
- Aktivera debug-loggning i utveckling
- Kontrollera nätverksförfrågningar till din backend
- Verifiera att API-nycklar är korrekt konfigurerade
- Testa på både iOS- och Android-plattformar
- Granska våra Tekniska FAQ för vanliga problem
- Använd Test vs Live-läge på rätt sätt