Integrazione del SDK React Native
Il Dodo Payments React Native SDK ti consente di creare esperienze di pagamento sicure nelle tue app native Android e iOS. Il nostro SDK fornisce componenti e schermate UI personalizzabili per la raccolta dei dettagli di pagamento.- 📦 Installa il nostro SDK da NPM
- 📚 Visualizza il nostro repository demo per esempi completi di implementazione
- 🎥 Guarda il nostro video demo per vedere il Dodo Payments SDK in azione
Caratteristiche
Sicurezza semplificata
Raccogli dati di pagamento sensibili in modo sicuro mantenendo la conformità PCI
Metodi di pagamento multipli
Accetta vari metodi di pagamento per espandere la portata globale
UI nativa
Schermate ed elementi nativi per Android e iOS
Attualmente, Apple Pay, Google Pay, Cash App e UPI non sono supportati nel SDK React Native. Stiamo lavorando attivamente per aggiungere supporto per questi metodi di pagamento nelle future versioni.
Installazione
1
Installa il SDK
Installa il Dodo Payments SDK utilizzando il tuo gestore di pacchetti preferito:
- npm
- yarn
2
Configurazione specifica della piattaforma
- iOS
- Android
Esegui pod install nella tua cartella iOS:
Configurazione lato client
1
Ottieni la chiave pubblicabile
Ottieni la tua chiave pubblicabile dal dashboard di Dodo Payments. (Distinta per le modalità di test e live)
https://app.dodopayments.com/developer/others
2
Configura il fornitore di pagamento
Avvolgi la tua app con il
DodoPaymentProvider:App.tsx
Dovrai generare chiavi API dal tuo dashboard di Dodo Payments. Consulta la nostra guida alla generazione delle chiavi API per istruzioni dettagliate.
3
Crea una funzione utility per i pagamenti
Crea una funzione utility per recuperare i parametri di pagamento dalla tua API backend:
utils/fetchPaymentParams.ts
Questa funzione presuppone che tu abbia un endpoint API backend che crea intenti di pagamento e restituisce un client secret. Assicurati che il tuo backend sia configurato correttamente per gestire la creazione dei pagamenti. Consulta il nostro Tutorial di integrazione API per esempi di configurazione del backend.
4
Implementa la schermata di pagamento
Crea la tua schermata di pagamento utilizzando il
useCheckout hook. Ecco un’implementazione completa:PaymentScreen.tsx
Per esempi completi con styling, gestione degli errori e opzioni di personalizzazione, dai un’occhiata ai nostri repository demo:
Opzioni di configurazione
Parametri di sessione
Il client secret dal tuo intento di pagamento, ottenuto dall’API di pagamento una tantum o abbonamento.
La modalità della sessione di pagamento (test o live).
Opzioni di personalizzazione per l’aspetto della schermata di pagamento
Modalità tema:
'light' o 'dark'Personalizzazione dell’aspetto
Puoi personalizzare il React Native Unified Checkout per adattarlo al design della tua app modificando colori, caratteri e altro tramite il parametro appearance quando chiamiinitPaymentSession().
Personalizzazione dei colori
Ogni categoria di colore determina il colore di uno o più componenti nell’interfaccia utente. Ad esempio,primary definisce il colore del pulsante di pagamento.
| Categoria di colore | Utilizzo |
|---|---|
primary | Colore primario per il pulsante di pagamento e gli elementi selezionati |
background | Colore di sfondo della pagina di pagamento |
componentBackground | Colore di sfondo per input, schede e altri componenti |
componentBorder | Colore del bordo esterno per input, schede e altri componenti |
componentDivider | Colore del bordo interno (bordi condivisi) per i componenti |
primaryText | Colore del testo dell’intestazione |
secondaryText | Colore del testo dell’etichetta per i campi di input |
componentText | Colore del testo di input (es. numero di carta, codice postale) |
placeholderText | Colore del testo segnaposto per i campi di input |
icon | Colore per le icone (es. pulsante di chiusura) |
error | Colore per i messaggi di errore e azioni distruttive |
Personalizzazione della forma
Puoi personalizzare il raggio del bordo, la larghezza del bordo e l’ombra utilizzati nell’interfaccia di pagamento:Personalizzazione specifica dei componenti
Puoi personalizzare componenti UI specifici come il pulsante primario (pulsante di pagamento). Queste impostazioni hanno la precedenza sulle impostazioni di aspetto globali:Gestione degli errori
Gestisci diversi stati di pagamento nella tua funzione di checkout:Scenari di errore comuni
Scenari di errore comuni
- Problemi di connettività di rete: Assicurati di avere una connessione internet stabile
- Client secret non valido: Verifica che il backend stia generando intenti di pagamento validi
- Dipendenze peer mancanti: Installa tutte le dipendenze richieste
- Configurazione specifica della piattaforma: Completa i passaggi di configurazione per iOS e Android
- Errori API: Controlla il nostro Riferimento ai codici di errore per una gestione degli errori dettagliata
Suggerimenti per il debug
Suggerimenti per il debug
- Abilita il logging di debug in fase di sviluppo
- Controlla le richieste di rete al tuo backend
- Verifica che le chiavi API siano configurate correttamente
- Testa su entrambe le piattaforme iOS e Android
- Rivedi le nostre FAQ tecniche per problemi comuni
- Usa Modalità di test vs live in modo appropriato