foundrex_flutter_mobile_sdk 0.0.3

foundrex_flutter_mobile_sdk: ^0.0.3 copied to clipboard

Foundrex Flutter Mobile SDK

The Foundrex Flutter Mobile SDK provides a unified, mobile-ready interface for payments and identity verification in Flutter applications.

It is designed to be: • Set-and-forget for app developers • Secure by default (no secrets in client apps) • Backend-driven (works with server-issued tokens) • Flutter & FlutterFlow friendly • Future-proof and vendor-agnostic

Applications integrate one SDK and access all supported flows through a single, consistent API.

⸻

✨ Features • Native payment flow with a modern payment sheet UI • Native identity verification (KYC) flow • Clean, minimal Dart API • No app-level native configuration required • No client-side secrets • Works with FlutterFlow custom actions • Designed for production and scale

⸻

🔐 Security Model

The Foundrex SDK never stores or generates secrets.

All sensitive operations (API keys, signing, access tokens) are expected to be handled server-side by your backend (for example via edge functions or API workers).

The mobile SDK only receives: • short-lived, scoped tokens • client-safe configuration values

This makes the SDK suitable for: • public distribution • enterprise environments • security audits • key rotation without app updates

⸻

📦 Installation

Add the SDK to your project: dependencies: foundrex_flutter_mobile_sdk: ^0.1.0

Then run: flutter pub get

🚀 Getting Started

Initialize the SDK

Call this once at app startup with a publishable configuration value received from your backend.

await Foundrex.initializeStripe( publishableKey: '<publishable_key_from_backend>', );

⸻

💳 Payments

To present the native payment flow, request a client secret from your backend and pass it to the SDK: await Foundrex.payments.presentPaymentSheet( clientSecret: '<client_secret_from_backend>', );

The SDK handles: • UI presentation • native lifecycle • user interaction • completion / cancellation

⸻

🧾 Identity Verification (KYC)

To start identity verification, request an access token from your backend and pass it to the SDK: await Foundrex.kyc.start( accessToken: '<kyc_access_token_from_backend>', );

The SDK will: • launch the native verification UI • handle the full verification flow • return control to your app when complete

All result handling (database updates, navigation, analytics) should be handled by your app or backend.

⸻

🧩 FlutterFlow Usage

The SDK works seamlessly with FlutterFlow using Custom Actions.

Typical FlutterFlow flow: 1. Call your backend (Supabase / API / Edge Function) 2. Receive a payment or verification token 3. Call the Foundrex SDK with that token

Example Custom Action call: await Foundrex.kyc.start(accessToken);

No native configuration is required in FlutterFlow.

⸻

🧠 Design Philosophy • One SDK, many capabilities • Apps orchestrate, SDK executes • Backend owns secrets • Mobile focuses on UX

This architecture allows: • backend changes without app updates • swapping providers without breaking apps • clean separation of concerns • long-term maintainability

📄 License

This SDK is released under the MIT License.

⸻

📬 Support

For questions, integration help, or enterprise usage, contact:

Foundrex 📧 [email protected]