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
Simplified Security
Raccogli in modo sicuro i dati di pagamento sensibili mantenendoti conforme a PCI
Multiple Payment Methods
Accetta vari metodi di pagamento per ampliare la portata globale
Native UI
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 il supporto a questi metodi di pagamento nelle prossime release.
Installazione
1
Install the SDK
Installa il Dodo Payments SDK utilizzando il tuo gestore di pacchetti preferito:
- npm
- yarn
2
Platform-specific setup
- iOS
- Android
Esegui pod install nella cartella iOS:
Configurazione lato client
1
Get Publishable Key
Ottieni la tua chiave pubblicabile dalla dashboard di Dodo Payments. (Distinta per le modalità test e live)
https://app.dodopayments.com/developer/others
2
Setup Payment Provider
Avvolgi la tua app con il
DodoPaymentProvider:App.tsx
Dovrai generare le chiavi API dalla dashboard di Dodo Payments. Consulta la nostra guida alla generazione delle chiavi API per istruzioni dettagliate.
3
Create payment utility function
Crea una funzione di utilità per recuperare i parametri di pagamento dalla tua API backend:
utils/fetchPaymentParams.ts
Questa funzione presume che tu abbia un endpoint API backend che crea intenti di pagamento e restituisce un client secret. Assicurati che il backend sia configurato correttamente per gestire la creazione dei pagamenti. Consulta il nostro Tutorial sull’integrazione API per esempi di configurazione del backend.
4
Implement the payment screen
Crea la tua schermata di pagamento utilizzando il hook
useCheckout. Ecco un’implementazione completa:PaymentScreen.tsx
Per esempi completi con styling, gestione degli errori e opzioni di personalizzazione, consulta i nostri repository demo:
Opzioni di configurazione
Parametri di sessione
Il client secret del tuo intento di pagamento, ottenuto dall’API One time payment o subscription.
La modalità della sessione di pagamento (test o live).
Opzioni di personalizzazione per l’aspetto della payment sheet
Modalità tema:
'light' o 'dark'Personalizzazione dell’aspetto
Puoi personalizzare il React Native Unified Checkout per adattarlo al design della tua app modificando colori, font e altro tramite il parametro appearance quando chiamiinitPaymentSession().
Personalizzazione dei colori
Ogni categoria di colore determina il colore di uno o più componenti dell’interfaccia. Ad esempio,primary definisce il colore del pulsante Paga.
Esempio di configurazione con supporto per modalità chiara e scura:
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:Common Error Scenarios
Common Error Scenarios
- Problemi di connettività di rete: assicurati di avere una connessione Internet stabile
- Client secret non valido: verifica che il backend generi 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: consulta il nostro Riferimento codici di errore per una gestione dettagliata degli errori
Debugging Tips
Debugging Tips
- 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
- Consulta le nostre FAQ Tecniche per problemi comuni
- Usa correttamente la Modalità Test vs Live