masamune_purchase_stripe 3.7.7

Masamune framework plugin for billing with Stripe; requires registration with Stripe.

Masamune Purchase Stripe

---

[GitHub] | [YouTube] | [Packages] | [X] | [LinkedIn] | [mathru.net]

---

Masamune Purchase Stripe

Usage

Installation

1. Add the package to your project.

flutter pub add masamune_purchase_stripe

Setup

2. Register the Stripe purchase adapter in your Masamune configuration.

// lib/main.dart

import 'package:masamune_purchase_stripe/masamune_purchase_stripe.dart';
import 'package:katana_functions_firebase/katana_functions_firebase.dart';
import 'package:katana_model_firestore/katana_model_firestore.dart';

final functionsAdapter = FirebaseFunctionsAdapter(
  options: DefaultFirebaseOptions.currentPlatform,
  region: FirebaseRegion.asiaNortheast1,
);

final modelAdapter = const FirestoreModelAdapter(
  options: DefaultFirebaseOptions.currentPlatform,
);

final masamuneAdapters = <MasamuneAdapter>[
  StripePurchaseMasamuneAdapter(
    callbackURLSchemeOrHost: Uri.parse('yourapp://stripe'),  // For 3D Secure redirects
    supportEmail: '[e-mail]',                     // Customer support email
    functionsAdapter: functionsAdapter,                      // Backend integration
    modelAdapter: modelAdapter,                              // Data persistence
  ),
];

void main() {
  runMasamuneApp(
    appRef: appRef,
    modelAdapter: modelAdapter,
    masamuneAdapters: masamuneAdapters,
    (appRef, _) => MasamuneApp(
      appRef: appRef,
      home: HomePage(),
    ),
  );
}

Create Stripe Customer

3. Create or update a Stripe customer with payment method:

class PaymentSetupPage extends PageScopedWidget {
  @override
  Widget build(BuildContext context, PageRef ref) {
    final functions = ref.app.functions();

    return ElevatedButton(
      onPressed: () async {
        try {
          // Create/update Stripe customer and payment method
          await functions.execute(
            StripeActionCreateCustomerAndPayment(
              email: '[e-mail]',
              paymentMethodId: 'pm_xxx',  // From Stripe.js or mobile SDK
            ),
          );
          print("Payment method saved!");
        } catch (e) {
          print("Failed to save payment: $e");
        }
      },
      child: const Text("Save Payment Method"),
    );
  }
}

Process a Purchase

4. Initiate a purchase or subscription:

Future<void> purchasePremium() async {
  final functions = ref.app.functions();
  
  try {
    final result = await functions.execute(
      StripeActionCreatePurchase(
        amount: 1200,                           // Amount in smallest currency unit (e.g., cents)
        currency: StripeCurrency.jpy,          // Currency
        description: 'Premium Plan - Monthly', // Purchase description
        metadata: {                             // Optional metadata
          'plan': 'premium',
          'period': 'monthly',
        },
      ),
    );
    
    print("Purchase successful: ${result.purchaseId}");
    // Navigate to success page
  } on StripePaymentException catch (e) {
    print("Payment failed: ${e.message}");
    // Show error dialog
  }
}

Track Purchase State

5. Use the generated models to track purchases and payment status:

class PurchaseHistoryPage extends PageScopedWidget {
  @override
  Widget build(BuildContext context, PageRef ref) {
    // Load user's purchases
    final purchases = ref.app.model(
      StripePurchaseModel.collection(userId: currentUserId),
    )..load();

    return ListView.builder(
      itemCount: purchases.length,
      itemBuilder: (context, index) {
        final purchase = purchases[index].value;
        return ListTile(
          title: Text(purchase?.description ?? ''),
          subtitle: Text('${purchase?.amount} ${purchase?.currency}'),
          trailing: Text(purchase?.status ?? ''),
        );
      },
    );
  }
}

Backend Implementation

Your Cloud Functions must implement Stripe integration:

// Cloud Functions
export const stripe = functions.https.onCall(async (data, context) => {
  const stripe = require('stripe')(process.env.STRIPE_SECRET_KEY);
  
  switch (data.action) {
    case "create_customer_and_payment":
      // Create Stripe customer and attach payment method
      const customer = await stripe.customers.create({
        email: data.email,
      });
      await stripe.paymentMethods.attach(data.paymentMethodId, {
        customer: customer.id,
      });
      return { customerId: customer.id };
      
    case "create_purchase":
      // Create payment intent
      const paymentIntent = await stripe.paymentIntents.create({
        amount: data.amount,
        currency: data.currency,
        description: data.description,
        metadata: data.metadata,
      });
      return { purchaseId: paymentIntent.id };
  }
});

GitHub Sponsors

Sponsors are always welcome. Thank you for your support!

https://github.com/sponsors/mathrunet