Hybrid Stripe Payments #

A Flutter plugin that provides a unified Dart API to present native Stripe PaymentSheet and SetupSheet on Android and iOS. It wraps the official Stripe SDKs so you can collect payments or save payment methods with minimal setup.

Platform	Min version	Stripe SDK
Android	API 24	`com.stripe:stripe-android:21.20.2`
iOS	13.0	`StripePaymentSheet` (CocoaPods)

Features #

Collect payments — present the Stripe PaymentSheet backed by a PaymentIntent.
Save payment methods — present a setup sheet backed by a SetupIntent to attach a card without charging.
Customizable UI — set the merchant name, primary button color, and button label.
Delayed payment methods — optionally allow methods like SEPA Debit or Sofort that confirm asynchronously.

Installation #

Add this package to your pubspec.yaml:

dependencies:
  hybrid_stripe_payments: ^1.0.0

Quick start #

1. Initialize the plugin #

Call initialize once at app startup (e.g. in main() or a splash screen):

import 'package:hybrid_stripe_payments/hybrid_stripe_payments.dart';

final stripePayments = HybridStripePaymentsImpl();

await stripePayments.initialize(
  HybridStripePaymentsOptions(
    publishableKey: 'pk_test_xxx',
    merchantName: 'My Store',
    primaryButtonColor: Colors.blue,
    allowsDelayedPaymentMethods: true,
  ),
);

2. Collect a payment #

Create a PaymentIntent on your backend, then pass the returned keys to showPaymentSheet:

final result = await stripePayments.showPaymentSheet(
  keys: HybridStripePaymentsKeys(
    customerId: 'cus_xxx',
    ephemeralKey: 'ek_test_xxx',
    type: HybridStripePaymentsKeyType.payment,
    intentId: 'pi_xxx',
    clientSecret: 'pi_xxx_secret_xxx',
  ),
  buttonLabel: 'Pay now', // optional
);

switch (result) {
  case HybridStripePaymentsResult.completed:
    // Show a confirmation screen.
    // Wait for a webhook event to fulfill the order.
    break;
  case HybridStripePaymentsResult.canceled:
    // The customer dismissed the sheet.
    break;
}

3. Save a payment method (no charge) #

Create a SetupIntent on your backend, then call setupStripeSheet:

final result = await stripePayments.setupStripeSheet(
  keys: HybridStripePaymentsKeys(
    customerId: 'cus_xxx',
    ephemeralKey: 'ek_test_xxx',
    type: HybridStripePaymentsKeyType.setup,
    intentId: 'seti_xxx',
    clientSecret: 'seti_xxx_secret_xxx',
  ),
  buttonLabel: 'Save card', // optional
);

API reference #