Hoppa till huvudinnehåll

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:
2

Platform-specific setup

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

clientSecret
string
obligatorisk
Klientsecreten från din betalningsavsikt, hämtad från One time payment- eller abonnemangs-API:et.
mode
string
obligatorisk
Läget för betalningssessionen (test eller live).
configuration.appearance
object
Anpassningsalternativ för betalningssidan utseende
configuration.appearance.themes
string
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 kallar initPaymentSession().

Färganpassning

Varje färgkategori bestämmer färgen för en eller flera komponenter i användargränssnittet. Till exempel definierar primary 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:
För att tillämpa dessa anpassningar, inkludera dem i din betalningssessionskonfiguration:

Felhantering

Hantera olika betalningstillstånd i din kassa-funktion:
  • 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
  • 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

Testbetalningsmetoder

Använd testkortnummer i utveckling för att verifiera din integration utan att genomföra riktiga betalningar. Läs mer om vår testprocess och tillgängliga testmiljöer.
Senast ändrad 28 maj 2026