Flutter Stripe

The stripe_js package provides Stripe.js bindings specifically for dart2js. It allows developers to access Stripe JS functionality from Dart code.

Warning: This package is in a very early stage. Use it with caution in production environments.

Google Pay integration requires a server-side implementation to securely manage Stripe API objects. Your server must provide an endpoint that performs the following:

1. Retrieve or Create a Customer: (Optional) Required if you want to save cards for future use.
2. Create an Ephemeral Key: (Optional) Required if using a Customer object to grant the SDK temporary access to sensitive customer data.
3. Create a PaymentIntent: Represents the intent to collect payment. You must pass the Customer ID if applicable.
4. Return Data to App: The endpoint must return the PaymentIntent client secret, the Ephemeral Key secret, and the Customer ID to the Flutter app.

Do not rely solely on client-side callbacks to confirm a successful payment, as users might close the app or lose connection during the process.

Instead, listen for the payment_intent.succeeded event using Stripe Webhooks on your server. This is the reliable way to trigger post-payment actions like sending order confirmation emails or updating your database.

You can control the behavior and appearance of the Address Sheet using the AddressSheetParams configuration object. Customization options include:

• Setting default values for address fields.
• Configuring which fields are required.
• Customizing the visual appearance.
• Setting specific country restrictions.

There are three primary ways to handle card payments. Stripe recommends using Payment Sheet for all new integrations.

ACH Direct Debit is a delayed notification payment method; funds typically take around 4 days to transfer.

Do not rely on client-side callbacks to confirm successful payments, as users may close the app before the callback executes. Instead, implement a server-side webhook to listen for the payment_intent.succeeded event. This is the reliable way to trigger post-payment workflows like order confirmations or shipping.

To securely finalize orders, listen for asynchronous Stripe events on your server rather than relying on client-side callbacks.

When a payment completes, Stripe sends a payment_intent.succeeded event. Use this event to:

• Send order confirmation emails.
• Log sales in your database.
• Trigger shipping workflows.

This approach is more robust because it handles cases where the customer closes the browser or quits the app before the client-side redirect finishes.

The Customer Sheet requires a backend endpoint to securely handle sensitive Stripe objects. Your server must provide the following three pieces of information to the client:

1. SetupIntent client secret: From a SetupIntent object used to track the intent to collect payment methods.
2. Customer ID: The ID of the Customer object to which payment methods will be attached.
3. Customer Ephemeral Key secret: A temporary key that grants the mobile SDK secure, limited access to the Customer object.

Note: If you do not intend to save cards for future use, you can omit the Customer and Ephemeral Key objects.

To use Stripe in a Flutter Web project, you must include both flutter_stripe and flutter_stripe_web in your pubspec.yaml file.

Note: This package is currently in a very early stage; use it with caution in production environments.

dependencies:
  flutter_stripe: ^latest_version
  flutter_stripe_web: ^latest_version

Before using the SDK, you must configure it with your Stripe publishable key during app initialization (usually in the main function). Use your test mode keys during development and live mode keys when publishing.

void main() async {
  Stripe.publishableKey = stripePublishableKey;
  runApp(const App());
}