FlowAlp

SDK React Native

September 8, 2026

Installa l'SDK React Native ufficiale di FlowAlp Pay: checkout ospitato in WebView, deep link, proxy Gateway lato backend e integrazione mobile sicura per iOS e Android.

Il pacchetto @flowalp/pay-react-native è l'SDK React Native ufficiale di FlowAlp. Apre il checkout FlowAlp Pay ospitato in una WebView, gestisce i deep link di ritorno nell'app e mantiene l'API Secret del Merchant API sul backend — lo stesso pattern sicuro descritto in integrazione app mobile.

Architettura

  1. Il tuo backend crea un Gateway con POST /Gateway/ e restituisce l'URL link.
  2. La tua app React Native apre quell'URL con FlowAlpPayCheckout o FlowAlpPayModal.
  3. I deep link (myapp://payment/success?referenceId=…) riportano il cliente nell'app.
  4. Il tuo backend conferma il pagamento tramite webhook o retrieve della transazione — non basarti solo sul redirect.

Non incorporare mai l'API Secret di FlowAlp Pay in un'app mobile o in un repository pubblico. L'SDK chiama il tuo backend; il tuo backend chiama FlowAlp Pay. Vedi credenziali API.

Ottieni l'SDK

Clona il repositorybash
git clone https://repo.flowalp.com/flowalpsdk/flowalppayreactnative.git
cd flowalppayreactnative
npm install
Installa nell'appbash
npm install @flowalp/pay-react-native react-native-webview
cd ios && pod install

Avvio rapido

Avvolgi l'app con FlowAlpPayProvider, poi avvia il checkout con useFlowAlpPayCheckout. Gli importi usano le unità minori (CHF 25,00 → 2500) — usa l'helper toMinorUnits dell'SDK. Il backend deve fare da proxy alla creazione del Gateway; codice Express di esempio in server-examples/node-express.js nel repository.

Deep link

Registra lo schema URL su iOS e Android. Percorsi predefiniti: myapp://payment/success, failed e cancel con referenceId in query. Usa usePaymentDeepLink per gestire i redirect quando l'app torna in primo piano.

Test e go-live

Repository: https://repo.flowalp.com/flowalpsdk/flowalppayreactnative.git — README completo con diagrammi, sicurezza ed esempi webhook.