@stripe/stripe-react-native 0.20.0 → 0.21.0

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 ## Unreleased
 
+## 0.21.0 - 2022-11-15
+
+### Breaking changes
+
+### New features
+
+- Added the `<AddressSheet />` component, which enables you to collect local and international shipping or billing addresses from your customers _with_ address autocomplete. [#1169](https://github.com/stripe/stripe-react-native/pull/1169)
+- Added the `defaultShippingDetails` field to the `params` argument in `initPaymentSheet(params)`. This will allow you to collect shipping details (either in your own UI or using the new `<AddressSheet />` component) for payments in the Payment Sheet. [#1169](https://github.com/stripe/stripe-react-native/pull/1169)
+
+## Fixes
+
+- Fixed a build error on Android when using Kotlin version 1.7.10. [#1195](https://github.com/stripe/stripe-react-native/pull/1195)
+
 ## 0.20.0 - 2022-11-03
 
 ### Breaking changes

package/android/gradle.properties

@@ -1,2 +1,2 @@
 StripeSdk_kotlinVersion=1.6.21
-StripeSdk_stripeVersion=20.15.+
+StripeSdk_stripeVersion=20.16.+

package/android/src/main/java/com/reactnativestripesdk/CollectBankAccountLauncherFragment.kt

@@ -91,6 +91,6 @@ class CollectBankAccountLauncherFragment(
   }
 
   companion object {
-    const val TAG = "collect_bank_account_launcher_fragment"
+    internal const val TAG = "collect_bank_account_launcher_fragment"
   }
 }

package/android/src/main/java/com/reactnativestripesdk/FinancialConnectionsSheetFragment.kt

@@ -125,7 +125,7 @@ class FinancialConnectionsSheetFragment : Fragment() {
   private fun commitFragmentAndStartFlow(currentActivity: AppCompatActivity) {
     try {
       currentActivity.supportFragmentManager.beginTransaction()
-        .add(this, "financial_connections_sheet_launch_fragment")
+        .add(this, TAG)
         .commit()
     } catch (error: IllegalStateException) {
       promise.resolve(createError(ErrorType.Failed.toString(), error.message))
@@ -133,6 +133,8 @@ class FinancialConnectionsSheetFragment : Fragment() {
   }
 
   companion object {
+    internal const val TAG = "financial_connections_sheet_launch_fragment"
+
     private fun createTokenResult(result: FinancialConnectionsSheetForTokenResult.Completed): WritableMap {
       return WritableNativeMap().also {
         it.putMap("session", mapFromSession(result.financialConnectionsSession))
@@ -239,6 +241,7 @@ class FinancialConnectionsSheetFragment : Fragment() {
         FinancialConnectionsAccount.Permissions.TRANSACTIONS -> "transactions"
         FinancialConnectionsAccount.Permissions.ACCOUNT_NUMBERS -> "accountNumbers"
         FinancialConnectionsAccount.Permissions.UNKNOWN -> "unparsable"
+        FinancialConnectionsAccount.Permissions.ACCOUNT_NUMBERS -> "accountNumbers"
       }
     }
 

package/android/src/main/java/com/reactnativestripesdk/GooglePayFragment.kt

@@ -206,6 +206,6 @@ class GooglePayFragment(private val initPromise: Promise) : Fragment() {
   }
 
   companion object {
-    const val TAG = "google_pay_launch_fragment"
+    internal const val TAG = "google_pay_launch_fragment"
   }
 }

package/android/src/main/java/com/reactnativestripesdk/PaymentLauncherFragment.kt

@@ -120,7 +120,7 @@ class PaymentLauncherFragment(
       }
     }
 
-    const val TAG = "payment_launcher_fragment"
+    internal const val TAG = "payment_launcher_fragment"
   }
 
   override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?,

package/android/src/main/java/com/reactnativestripesdk/PaymentSheetAppearance.kt

@@ -2,27 +2,28 @@ package com.reactnativestripesdk
 
 import android.graphics.Color
 import android.os.Bundle
+import com.facebook.react.bridge.ReactContext
 import com.reactnativestripesdk.utils.PaymentSheetAppearanceException
 import com.stripe.android.paymentsheet.PaymentSheet
 
-fun PaymentSheetFragment.buildPaymentSheetAppearance(userParams: Bundle?): PaymentSheet.Appearance {
+fun buildPaymentSheetAppearance(userParams: Bundle?, context: ReactContext): PaymentSheet.Appearance {
   val colorParams = userParams?.getBundle(PaymentSheetAppearanceKeys.COLORS)
   val lightColorParams = colorParams?.getBundle(PaymentSheetAppearanceKeys.LIGHT) ?: colorParams
   val darkColorParams = colorParams?.getBundle(PaymentSheetAppearanceKeys.DARK) ?: colorParams
 
   return PaymentSheet.Appearance(
-    typography = buildTypography(userParams?.getBundle(PaymentSheetAppearanceKeys.FONT)),
+    typography = buildTypography(userParams?.getBundle(PaymentSheetAppearanceKeys.FONT), context),
     colorsLight = buildColors(lightColorParams, PaymentSheet.Colors.defaultLight),
     colorsDark = buildColors(darkColorParams, PaymentSheet.Colors.defaultDark),
     shapes = buildShapes(userParams?.getBundle(PaymentSheetAppearanceKeys.SHAPES)),
-    primaryButton = buildPrimaryButton(userParams?.getBundle(PaymentSheetAppearanceKeys.PRIMARY_BUTTON))
+    primaryButton = buildPrimaryButton(userParams?.getBundle(PaymentSheetAppearanceKeys.PRIMARY_BUTTON), context)
   )
 }
 
-private fun PaymentSheetFragment.buildTypography(fontParams: Bundle?): PaymentSheet.Typography {
+private fun buildTypography(fontParams: Bundle?, context: ReactContext): PaymentSheet.Typography {
   return PaymentSheet.Typography.default.copy(
     sizeScaleFactor = getFloatOr(fontParams, PaymentSheetAppearanceKeys.SCALE, PaymentSheet.Typography.default.sizeScaleFactor),
-    fontResId = getFontResId(fontParams, PaymentSheetAppearanceKeys.FAMILY, PaymentSheet.Typography.default.fontResId)
+    fontResId = getFontResId(fontParams, PaymentSheetAppearanceKeys.FAMILY, PaymentSheet.Typography.default.fontResId, context)
   )
 }
 
@@ -64,7 +65,7 @@ private fun buildShapes(shapeParams: Bundle?): PaymentSheet.Shapes {
   )
 }
 
-private fun PaymentSheetFragment.buildPrimaryButton(params: Bundle?): PaymentSheet.PrimaryButton {
+private fun buildPrimaryButton(params: Bundle?, context: ReactContext): PaymentSheet.PrimaryButton {
   if (params == null) {
     return PaymentSheet.PrimaryButton()
   }
@@ -83,7 +84,7 @@ private fun PaymentSheetFragment.buildPrimaryButton(params: Bundle?): PaymentShe
       borderStrokeWidthDp = getFloatOrNull(shapeParams, PaymentSheetAppearanceKeys.BORDER_WIDTH),
     ),
     typography = PaymentSheet.PrimaryButtonTypography(
-      fontResId = getFontResId(fontParams, PaymentSheetAppearanceKeys.FAMILY, null)
+      fontResId = getFontResId(fontParams, PaymentSheetAppearanceKeys.FAMILY, null, context)
     )
   )
 }
@@ -120,7 +121,7 @@ private fun getFloatOrNull(bundle: Bundle?, key: String): Float? {
 }
 
 @Throws(PaymentSheetAppearanceException::class)
-private fun PaymentSheetFragment.getFontResId(bundle: Bundle?, key: String, defaultValue: Int?): Int? {
+private fun getFontResId(bundle: Bundle?, key: String, defaultValue: Int?, context: ReactContext): Int? {
   val fontErrorPrefix = "Encountered an error when setting a custom font:"
   if (bundle?.containsKey(key) != true) {
     return defaultValue
@@ -134,7 +135,7 @@ private fun PaymentSheetFragment.getFontResId(bundle: Bundle?, key: String, defa
     )
   }
 
-  val id = resources.getIdentifier(fontFileName, "font", context?.packageName)
+  val id = context.resources.getIdentifier(fontFileName, "font", context.packageName)
   if (id == 0) {
     throw PaymentSheetAppearanceException("$fontErrorPrefix Failed to find font: $fontFileName")
   } else {

package/android/src/main/java/com/reactnativestripesdk/PaymentSheetFragment.kt

@@ -10,7 +10,6 @@ import android.view.LayoutInflater
 import android.view.View
 import android.view.ViewGroup
 import android.widget.FrameLayout
-import androidx.appcompat.app.AppCompatActivity
 import androidx.appcompat.content.res.AppCompatResources
 import androidx.core.graphics.drawable.DrawableCompat
 import androidx.fragment.app.Fragment
@@ -18,6 +17,7 @@ import com.facebook.react.bridge.Promise
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.WritableMap
 import com.facebook.react.bridge.WritableNativeMap
+import com.reactnativestripesdk.addresssheet.AddressSheetView
 import com.reactnativestripesdk.utils.*
 import com.reactnativestripesdk.utils.createError
 import com.reactnativestripesdk.utils.createResult
@@ -65,12 +65,16 @@ class PaymentSheetFragment(
     paymentIntentClientSecret = arguments?.getString("paymentIntentClientSecret").orEmpty()
     setupIntentClientSecret = arguments?.getString("setupIntentClientSecret").orEmpty()
     val appearance = try {
-      buildPaymentSheetAppearance(arguments?.getBundle("appearance"))
+      buildPaymentSheetAppearance(arguments?.getBundle("appearance"), context)
     } catch (error: PaymentSheetAppearanceException) {
       initPromise.resolve(createError(ErrorType.Failed.toString(), error))
       return
     }
 
+    val shippingDetails = arguments?.getBundle("defaultShippingDetails")?.let {
+      AddressSheetView.buildAddressDetails(it)
+    }
+
     val paymentOptionCallback = PaymentOptionCallback { paymentOption ->
       val result = paymentOption?.let {
         val bitmap = getBitmapFromVectorDrawable(context, it.drawableResourceId)
@@ -128,6 +132,7 @@ class PaymentSheetFragment(
       ) else null,
       googlePay = googlePayConfig,
       appearance = appearance,
+      shippingDetails = shippingDetails,
       primaryButtonLabel = primaryButtonLabel
     )
 
@@ -198,7 +203,7 @@ class PaymentSheetFragment(
   }
 
   companion object {
-    const val TAG = "payment_sheet_launch_fragment"
+    internal const val TAG = "payment_sheet_launch_fragment"
 
     internal fun buildGooglePayConfig(params: Bundle?): PaymentSheet.GooglePayConfiguration? {
       if (params == null) {

package/android/src/main/java/com/reactnativestripesdk/StripeSdkModule.kt

@@ -5,13 +5,11 @@ import android.content.Intent
 import android.os.Parcelable
 import android.util.Log
 import androidx.appcompat.app.AppCompatActivity
-import androidx.fragment.app.Fragment
 import com.facebook.react.bridge.*
 import com.facebook.react.module.annotations.ReactModule
+import com.reactnativestripesdk.addresssheet.AddressLauncherFragment
 import com.reactnativestripesdk.pushprovisioning.PushProvisioningProxy
 import com.reactnativestripesdk.utils.*
-import com.reactnativestripesdk.utils.createError
-import com.reactnativestripesdk.utils.createMissingActivityError
 import com.stripe.android.*
 import com.stripe.android.core.ApiVersion
 import com.stripe.android.core.AppInfo
@@ -45,14 +43,17 @@ class StripeSdkModule(reactContext: ReactApplicationContext) : ReactContextBaseJ
   private var googlePayFragment: GooglePayFragment? = null
   private var paymentLauncherFragment: PaymentLauncherFragment? = null
   private var collectBankAccountLauncherFragment: CollectBankAccountLauncherFragment? = null
-  private var financialConnectionsSheetFragment: FinancialConnectionsSheetFragment? = null
-  private val allFragments: List<Fragment?>
+
+  // If you create a new Fragment, you must put the tag here, otherwise result callbacks for that
+  // Fragment will not work on RN < 0.65
+  private val allStripeFragmentTags: List<String>
     get() = listOf(
-      paymentSheetFragment,
-      googlePayFragment,
-      paymentLauncherFragment,
-      collectBankAccountLauncherFragment,
-      financialConnectionsSheetFragment
+      PaymentSheetFragment.TAG,
+      GooglePayFragment.TAG,
+      PaymentLauncherFragment.TAG,
+      CollectBankAccountLauncherFragment.TAG,
+      FinancialConnectionsSheetFragment.TAG,
+      AddressLauncherFragment.TAG
     )
 
   private val mActivityEventListener = object : BaseActivityEventListener() {
@@ -77,8 +78,12 @@ class StripeSdkModule(reactContext: ReactApplicationContext) : ReactContextBaseJ
 
   // Necessary on older versions of React Native (~0.65 and below)
   private fun dispatchActivityResultsToFragments(requestCode: Int, resultCode: Int, data: Intent?) {
-    for (fragment in allFragments) {
-      fragment?.activity?.activityResultRegistry?.dispatchResult(requestCode, resultCode, data)
+    getCurrentActivityOrResolveWithError(null)?.supportFragmentManager?.let { fragmentManager ->
+      for (tag in allStripeFragmentTags) {
+        fragmentManager.findFragmentByTag(tag)?.let {
+          it.activity?.activityResultRegistry?.dispatchResult(requestCode, resultCode, data)
+        }
+      }
     }
   }
 
@@ -120,6 +125,7 @@ class StripeSdkModule(reactContext: ReactApplicationContext) : ReactContextBaseJ
     }
 
     this.publishableKey = publishableKey
+    AddressLauncherFragment.publishableKey = publishableKey
 
     val name = getValOr(appInfo, "name", "") as String
     val partnerId = getValOr(appInfo, "partnerId", "")
@@ -718,7 +724,7 @@ class StripeSdkModule(reactContext: ReactApplicationContext) : ReactContextBaseJ
       promise.resolve(createMissingInitError())
       return
     }
-    financialConnectionsSheetFragment = FinancialConnectionsSheetFragment().also {
+    FinancialConnectionsSheetFragment().also {
       it.presentFinancialConnectionsSheet(clientSecret, FinancialConnectionsSheetFragment.Mode.ForToken, publishableKey, stripeAccountId, promise, reactApplicationContext)
     }
   }
@@ -729,7 +735,7 @@ class StripeSdkModule(reactContext: ReactApplicationContext) : ReactContextBaseJ
       promise.resolve(createMissingInitError())
       return
     }
-    financialConnectionsSheetFragment = FinancialConnectionsSheetFragment().also {
+    FinancialConnectionsSheetFragment().also {
       it.presentFinancialConnectionsSheet(clientSecret, FinancialConnectionsSheetFragment.Mode.ForSession, publishableKey, stripeAccountId, promise, reactApplicationContext)
     }
   }

package/android/src/main/java/com/reactnativestripesdk/StripeSdkPackage.kt

@@ -4,6 +4,7 @@ import com.facebook.react.ReactPackage
 import com.facebook.react.bridge.NativeModule
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.uimanager.ViewManager
+import com.reactnativestripesdk.addresssheet.AddressSheetViewManager
 import com.reactnativestripesdk.pushprovisioning.AddToWalletButtonManager
 
 class StripeSdkPackage : ReactPackage {
@@ -18,7 +19,8 @@ class StripeSdkPackage : ReactPackage {
         StripeContainerManager(),
         CardFormViewManager(),
         GooglePayButtonManager(),
-        AddToWalletButtonManager(reactContext)
+        AddToWalletButtonManager(reactContext),
+        AddressSheetViewManager()
       )
     }
 }

package/android/src/main/java/com/reactnativestripesdk/addresssheet/AddressLauncherFragment.kt

@@ -0,0 +1,111 @@
+package com.reactnativestripesdk.addresssheet
+
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import android.widget.FrameLayout
+import androidx.appcompat.app.AppCompatActivity
+import androidx.fragment.app.Fragment
+import com.facebook.react.bridge.ReactContext
+import com.facebook.react.bridge.WritableMap
+import com.reactnativestripesdk.utils.ErrorType
+import com.reactnativestripesdk.utils.createError
+import com.stripe.android.paymentsheet.PaymentSheet
+import com.stripe.android.paymentsheet.addresselement.AddressDetails
+import com.stripe.android.paymentsheet.addresselement.AddressLauncher
+import com.stripe.android.paymentsheet.addresselement.AddressLauncherResult
+
+class AddressLauncherFragment : Fragment() {
+  companion object {
+    internal var publishableKey: String? = null
+    internal const val TAG = "address_launcher_fragment"
+  }
+
+  private lateinit var addressLauncher: AddressLauncher
+  private var configuration = AddressLauncher.Configuration()
+  private var callback: ((error: WritableMap?, address: AddressDetails?) -> Unit)? = null
+
+  override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?,
+                            savedInstanceState: Bundle?): View {
+    return FrameLayout(requireActivity()).also {
+      it.visibility = View.GONE
+    }
+  }
+
+  override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
+    publishableKey?.let { publishableKey ->
+      addressLauncher = AddressLauncher(this,
+                                        ::onAddressLauncherResult).also {
+        it.present(
+          publishableKey = publishableKey,
+          configuration = configuration
+        )
+      }
+    } ?: run {
+      callback?.invoke(
+        createError(ErrorType.Failed.toString(), "No publishable key set. Stripe has not been initialized. Initialize Stripe in your app with the StripeProvider component or the initStripe method."),
+        null
+      )
+    }
+  }
+
+  private fun onAddressLauncherResult(result: AddressLauncherResult) {
+    when (result) {
+      is AddressLauncherResult.Canceled -> {
+        callback?.invoke(
+          createError(ErrorType.Canceled.toString(), "The flow has been canceled."),
+          null
+        )
+      }
+      is AddressLauncherResult.Succeeded -> {
+        callback?.invoke(
+          null,
+          result.address
+        )
+      }
+    }
+  }
+
+  fun presentAddressSheet(
+    context: ReactContext,
+    appearance: PaymentSheet.Appearance,
+    defaultAddress: AddressDetails?,
+    allowedCountries: Set<String>,
+    buttonTitle: String?,
+    title: String?,
+    googlePlacesApiKey: String?,
+    autocompleteCountries: Set<String>,
+    additionalFields: AddressLauncher.AdditionalFieldsConfiguration?,
+    callback: ((error: WritableMap?, address: AddressDetails?) -> Unit)) {
+    configuration = AddressLauncher.Configuration(
+      appearance = appearance,
+      address = defaultAddress,
+      allowedCountries = allowedCountries,
+      buttonTitle = buttonTitle,
+      additionalFields = additionalFields,
+      title = title,
+      googlePlacesApiKey = googlePlacesApiKey,
+      autocompleteCountries = autocompleteCountries,
+    )
+    this.callback = callback
+    (context.currentActivity as? AppCompatActivity)?.let {
+      attemptToCleanupPreviousFragment(it)
+      commitFragmentAndStartFlow(it)
+    }
+  }
+
+  private fun attemptToCleanupPreviousFragment(currentActivity: AppCompatActivity) {
+    currentActivity.supportFragmentManager.beginTransaction()
+      .remove(this)
+      .commitAllowingStateLoss()
+  }
+
+  private fun commitFragmentAndStartFlow(currentActivity: AppCompatActivity) {
+    try {
+      currentActivity.supportFragmentManager.beginTransaction()
+        .add(this, TAG)
+        .commit()
+    } catch (_: IllegalStateException) {}
+  }
+}

package/android/src/main/java/com/reactnativestripesdk/addresssheet/AddressSheetEvent.kt

@@ -0,0 +1,28 @@
+package com.reactnativestripesdk.addresssheet
+
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.uimanager.events.Event
+import com.facebook.react.uimanager.events.RCTEventEmitter
+
+internal class AddressSheetEvent constructor(viewTag: Int, private val eventType: EventType, private val eventMap: WritableMap?) : Event<AddressSheetEvent>(viewTag) {
+  enum class EventType {
+    OnSubmit,
+    OnError
+  }
+
+  override fun dispatch(rctEventEmitter: RCTEventEmitter) {
+    rctEventEmitter.receiveEvent(viewTag, eventName, eventMap)
+  }
+
+  companion object {
+    const val ON_SUBMIT = "onSubmitAction"
+    const val ON_ERROR = "onErrorAction"
+  }
+
+  override fun getEventName(): String {
+    return when (eventType) {
+      EventType.OnSubmit -> ON_SUBMIT
+      EventType.OnError -> ON_ERROR
+    }
+  }
+}

package/android/src/main/java/com/reactnativestripesdk/addresssheet/AddressSheetView.kt

@@ -0,0 +1,178 @@
+package com.reactnativestripesdk.addresssheet
+
+import android.os.Bundle
+import android.util.Log
+import android.widget.FrameLayout
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.bridge.WritableNativeMap
+import com.facebook.react.uimanager.ThemedReactContext
+import com.facebook.react.uimanager.UIManagerModule
+import com.facebook.react.uimanager.events.EventDispatcher
+import com.reactnativestripesdk.buildPaymentSheetAppearance
+import com.reactnativestripesdk.utils.ErrorType
+import com.reactnativestripesdk.utils.PaymentSheetAppearanceException
+import com.reactnativestripesdk.utils.createError
+import com.reactnativestripesdk.utils.toBundleObject
+import com.stripe.android.paymentsheet.PaymentSheet
+import com.stripe.android.paymentsheet.addresselement.AddressDetails
+import com.stripe.android.paymentsheet.addresselement.AddressLauncher
+import com.stripe.android.paymentsheet.addresselement.AddressLauncherResult
+
+class AddressSheetView(private val context: ThemedReactContext) : FrameLayout(context) {
+  private var eventDispatcher: EventDispatcher? = context.getNativeModule(UIManagerModule::class.java)?.eventDispatcher
+  private var isVisible = false
+  private var appearanceParams: ReadableMap? = null
+  private var defaultAddress: AddressDetails? = null
+  private var allowedCountries: Set<String> = emptySet()
+  private var buttonTitle: String? = null
+  private var sheetTitle: String? = null
+  private var googlePlacesApiKey: String? = null
+  private var autocompleteCountries: Set<String> = emptySet()
+  private var additionalFields: AddressLauncher.AdditionalFieldsConfiguration? = null
+
+  private fun onSubmit(params: WritableMap) {
+    eventDispatcher?.dispatchEvent(
+      AddressSheetEvent(id, AddressSheetEvent.EventType.OnSubmit, params)
+    )
+  }
+
+  private fun onError(params: WritableMap?) {
+    eventDispatcher?.dispatchEvent(
+      AddressSheetEvent(id, AddressSheetEvent.EventType.OnError, params)
+    )
+  }
+
+  fun setVisible(newVisibility: Boolean) {
+    if (newVisibility && !isVisible) {
+      launchAddressSheet()
+    } else if (!newVisibility && isVisible) {
+      Log.w("StripeReactNative", "Programmatically dismissing the Address Sheet is not supported on Android.")
+    }
+    isVisible = newVisibility
+  }
+
+  private fun launchAddressSheet() {
+    val appearance = try {
+      buildPaymentSheetAppearance(toBundleObject(appearanceParams), context)
+    } catch (error: PaymentSheetAppearanceException) {
+      onError(createError(ErrorType.Failed.toString(), error))
+      return
+    }
+    AddressLauncherFragment().presentAddressSheet(
+      context,
+      appearance,
+      defaultAddress,
+      allowedCountries,
+      buttonTitle,
+      sheetTitle,
+      googlePlacesApiKey,
+      autocompleteCountries,
+      additionalFields
+    ) { error, address ->
+      if (address != null) {
+        onSubmit(buildResult(address))
+      } else {
+        onError(error)
+      }
+      isVisible = false
+    }
+  }
+
+  fun setAppearance(appearanceParams: ReadableMap) {
+    this.appearanceParams = appearanceParams
+  }
+
+  fun setDefaultValues(defaults: ReadableMap) {
+    defaultAddress = buildAddressDetails(defaults)
+  }
+
+  fun setAdditionalFields(fields: ReadableMap) {
+    additionalFields = buildAdditionalFieldsConfiguration(fields)
+  }
+
+  fun setAllowedCountries(countries: List<String>) {
+    allowedCountries = countries.toSet()
+  }
+
+  fun setAutocompleteCountries(countries: List<String>) {
+    autocompleteCountries = countries.toSet()
+  }
+
+  fun setPrimaryButtonTitle(title: String) {
+    buttonTitle = title
+  }
+
+  fun setSheetTitle(title: String) {
+    sheetTitle = title
+  }
+
+  fun setGooglePlacesApiKey(key: String) {
+    googlePlacesApiKey = key
+  }
+
+  companion object {
+    internal fun buildAddressDetails(bundle: Bundle): AddressDetails {
+      return AddressDetails(
+        name = bundle.getString("name"),
+        address = buildAddress(bundle.getBundle("address")),
+        phoneNumber = bundle.getString("phone"),
+        isCheckboxSelected = bundle.getBoolean("isCheckboxSelected"),
+      )
+    }
+
+    internal fun buildAddressDetails(map: ReadableMap): AddressDetails {
+      return buildAddressDetails(toBundleObject(map))
+    }
+
+    internal fun buildAddress(bundle: Bundle?): PaymentSheet.Address? {
+      if (bundle == null) {
+        return null
+      }
+      return PaymentSheet.Address(
+        city = bundle.getString("city"),
+        country = bundle.getString("country"),
+        line1 = bundle.getString("line1"),
+        line2 = bundle.getString("line2"),
+        state = bundle.getString("state"),
+        postalCode = bundle.getString("postalCode")
+      )
+    }
+
+    internal fun getFieldConfiguration(key: String?): AddressLauncher.AdditionalFieldsConfiguration.FieldConfiguration {
+      return when (key) {
+        "hidden" -> AddressLauncher.AdditionalFieldsConfiguration.FieldConfiguration.HIDDEN
+        "optional" -> AddressLauncher.AdditionalFieldsConfiguration.FieldConfiguration.OPTIONAL
+        "required" -> AddressLauncher.AdditionalFieldsConfiguration.FieldConfiguration.REQUIRED
+        else -> AddressLauncher.AdditionalFieldsConfiguration.FieldConfiguration.HIDDEN
+      }
+    }
+
+    internal fun buildAdditionalFieldsConfiguration(params: ReadableMap): AddressLauncher.AdditionalFieldsConfiguration {
+      val phoneConfiguration = getFieldConfiguration(params.getString("phoneNumber"))
+
+      return AddressLauncher.AdditionalFieldsConfiguration(
+        phone = phoneConfiguration,
+        checkboxLabel = params.getString("checkboxLabel")
+      )
+    }
+
+    internal fun buildResult(addressDetails: AddressDetails): WritableMap {
+      val result = WritableNativeMap()
+      result.putString("name", addressDetails.name)
+      WritableNativeMap().let {
+        it.putString("city", addressDetails.address?.city)
+        it.putString("country", addressDetails.address?.country)
+        it.putString("line1", addressDetails.address?.line1)
+        it.putString("line2", addressDetails.address?.line2)
+        it.putString("postalCode", addressDetails.address?.postalCode)
+        it.putString("state", addressDetails.address?.state)
+        result.putMap("address", it)
+      }
+      result.putString("phone", addressDetails.phoneNumber)
+      result.putBoolean("isCheckboxSelected", addressDetails.isCheckboxSelected ?: false)
+      return result
+    }
+  }
+}