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
Install the SDK
Installa il Dodo Payments SDK utilizzando il tuo gestore di pacchetti preferito:
- npm
- yarn
Configurazione lato client
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
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.
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.
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.
| Categoria di colore | Utilizzo |
|---|---|
primary | Colore principale per il pulsante Paga 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 delle etichette per i campi di input |
componentText | Colore del testo dell’input (ad esempio, numero della carta, CAP) |
placeholderText | Colore del testo segnaposto per i campi di input |
icon | Colore delle icone (ad esempio, pulsante Chiudi) |
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: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 sviluppo
- Controlla le richieste di rete verso il tuo backend
- Verifica che le chiavi API siano configurate correttamente
- Testa sia su piattaforme iOS che Android
- Consulta le nostre FAQ tecniche per problemi comuni
- Utilizza correttamente Modalità test vs live