Feat: web language (#2267)

* Add locale selection for flutter web

* Update comments for locale selection for flutter web

---------

Co-authored-by: Rémon <[email protected]>

Author: flt-phy

packages/stripe/lib/src/stripe.dart

@@ -98,6 +98,20 @@ class Stripe {
     instance.markNeedsSettings();
   }
 
+  /// Retrieves the locale.
+  /// For now works on web only.
+  static String? get locale => instance._locale;
+
+  /// Sets the locale.
+  /// For now works on web only.
+  static set locale(String? value) {
+    if (value == instance._locale) {
+      return;
+    }
+    instance._locale = value;
+    instance.markNeedsSettings();
+  }
+
   /// Reconfigures the Stripe platform by applying the current values for
   /// [publishableKey], [merchantIdentifier], [stripeAccountId],
   /// [threeDSecureParams], [urlScheme], [setReturnUrlSchemeOnAndroid]
@@ -108,6 +122,7 @@ class Stripe {
     threeDSecureParams: threeDSecureParams,
     urlScheme: urlScheme,
     setReturnUrlSchemeOnAndroid: setReturnUrlSchemeOnAndroid,
+    locale: locale,
   );
 
   /// Exposes a [ValueListenable] whether or not GooglePay (on Android) or Apple Pay (on iOS)
@@ -707,6 +722,7 @@ class Stripe {
   String? _merchantIdentifier;
   String? _urlScheme;
   bool? _setReturnUrlSchemeOnAndroid;
+  String? _locale;
 
   static StripePlatform? __platform;
 
@@ -733,6 +749,7 @@ class Stripe {
     String? merchantIdentifier,
     String? urlScheme,
     bool? setReturnUrlSchemeOnAndroid,
+    String? locale,
   }) async {
     _needsSettings = false;
     await _platform.initialise(
@@ -742,6 +759,7 @@ class Stripe {
       merchantIdentifier: merchantIdentifier,
       urlScheme: urlScheme,
       setReturnUrlSchemeOnAndroid: setReturnUrlSchemeOnAndroid,
+      locale: locale,
     );
   }
 

packages/stripe_platform_interface/lib/src/method_channel_stripe.dart

@@ -53,6 +53,7 @@ class MethodChannelStripe extends StripePlatform {
     String? merchantIdentifier,
     String? urlScheme,
     bool? setReturnUrlSchemeOnAndroid,
+    String? locale,
   }) async {
     await _methodChannel.invokeMethod('initialise', {
       'publishableKey': publishableKey,
@@ -62,6 +63,7 @@ class MethodChannelStripe extends StripePlatform {
       'threeDSecureParams': threeDSecureParams,
       'urlScheme': urlScheme,
       'setReturnUrlSchemeOnAndroid': setReturnUrlSchemeOnAndroid,
+      'locale': locale,
     });
 
     _methodChannel.setMethodCallHandler((call) async {

packages/stripe_platform_interface/lib/src/stripe_platform_interface.dart

@@ -32,6 +32,7 @@ abstract class StripePlatform extends PlatformInterface {
     String? merchantIdentifier,
     String? urlScheme,
     bool? setReturnUrlSchemeOnAndroid,
+    String? locale,
   });
 
   Future<PaymentMethod> createPaymentMethod(

packages/stripe_web/lib/src/web_stripe.dart

@@ -52,16 +52,23 @@ class WebStripe extends StripePlatform {
     String? merchantIdentifier,
     String? urlScheme,
     bool? setReturnUrlSchemeOnAndroid,
+    String? locale,
   }) async {
     _urlScheme = urlScheme;
 
     if (__stripe != null) {
-      // Check if the new stripeAccountId is different
-      if (__stripe!.stripeAccount != stripeAccountId) {
-        // Re-initialize with new stripeAccountId
+      // Check if the new stripeAccountId or locale is different
+      if (__stripe!.stripeAccount != stripeAccountId || __stripe!.locale != locale) {
+        // Re-initialize with new stripeAccountId or locale
         await stripe_js.loadStripe();
         var stripeOption = stripe_js.StripeOptions();
-        stripeOption.stripeAccount = stripeAccountId;
+        if (__stripe!.stripeAccount != stripeAccountId) {
+          stripeOption.stripeAccount = stripeAccountId;
+        }
+        if (locale != null && __stripe!.locale != locale) {
+          stripeOption.locale = locale;
+        }
+
         __stripe = stripe_js.Stripe(publishableKey, stripeOption);
       }
       return;
@@ -72,6 +79,9 @@ class WebStripe extends StripePlatform {
     if (stripeAccountId != null) {
       stripeOption.stripeAccount = stripeAccountId;
     }
+    if (locale != null) {
+      stripeOption.locale = locale;
+    }
     __stripe = stripe_js.Stripe(publishableKey, stripeOption);
   }