FlowAlp

SDK React Native

September 8, 2026

Installez le SDK React Native officiel FlowAlp Pay : checkout hébergé en WebView, deep links, proxy Gateway côté backend et intégration mobile sécurisée pour iOS et Android.

Le package @flowalp/pay-react-native est le SDK React Native officiel de FlowAlp. Il ouvre le checkout FlowAlp Pay hébergé dans une WebView, gère les deep links de retour dans votre app et garde le secret Merchant API sur votre backend — le même modèle sécurisé que l'intégration app mobile.

Architecture

  1. Votre backend crée une Gateway via POST /Gateway/ et renvoie l'URL link.
  2. Votre app React Native ouvre cette URL avec FlowAlpPayCheckout ou FlowAlpPayModal.
  3. Les deep links (myapp://payment/success?referenceId=…) ramènent le client dans l'app.
  4. Votre backend confirme le paiement via webhooks ou récupération de transaction — ne vous fiez pas au seul redirect.

N'intégrez jamais le secret API FlowAlp Pay dans une app mobile ou un dépôt public. Le SDK appelle votre backend ; votre backend appelle FlowAlp Pay. Voir identifiants API.

Obtenir le SDK

Cloner le dépôtbash
git clone https://repo.flowalp.com/flowalpsdk/flowalppayreactnative.git
cd flowalppayreactnative
npm install
Installer dans l'appbash
npm install @flowalp/pay-react-native react-native-webview
cd ios && pod install

Démarrage rapide

Enveloppez l'app avec FlowAlpPayProvider, puis lancez le checkout via useFlowAlpPayCheckout. Montants en unités mineures (CHF 25,00 → 2500) — helper toMinorUnits. Votre backend doit proxifier la création Gateway ; exemple Express dans server-examples/node-express.js du dépôt.

Deep linking

Enregistrez le schéma URL sur iOS et Android. Chemins par défaut : myapp://payment/success, failed et cancel avec referenceId. Utilisez usePaymentDeepLink pour les redirects depuis l'arrière-plan.

Tests et mise en production

  • Credentials de test et tests pour développeurs.
  • Authentifier l'endpoint backend de création Gateway.
  • Expédier les commandes uniquement sur webhook confirmed ou statut API vérifié.
  • Consulter la checklist go-live.

Dépôt : https://repo.flowalp.com/flowalpsdk/flowalppayreactnative.git — README complet avec architecture, sécurité et exemples webhooks.