Recopila las direcciones físicas y los números de teléfono

Primero, necesitas una cuenta de Stripe. Inscríbete ahora.

El SDK para Android de Stripe es de código abierto y está completamente documentado.

Para instalar el SDK, agrega stripe-android al bloque dependencies de tu archivo app/build.gradle:

plugins {
    id("com.android.application")
}

android { ... }

dependencies {
  // ...

  // Stripe Android SDK
  implementation("com.stripe:stripe-android:21.20.2")
  // Include the financial connections SDK to support US bank account as a payment method
  implementation("com.stripe:financial-connections:21.20.2")
}

Configura el SDK con tu clave publicable de Stripe para que pueda hacer solicitudes a la API de Stripe, así como en tu subclase Application:

import com.stripe.android.PaymentConfiguration

class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        PaymentConfiguration.init(
            applicationContext,
            
"pk_test_TYooMQauvdEDq54NiTphI7jx"
        )
    }
}

El Address Element utiliza el SDK de Google Places para obtener sugerencias de direcciones que se completen automáticamente. Para habilitar las sugerencias para autocompletar, debes incluir la dependencia del SDK de Google Places en el build.gradle de tu aplicación.

dependencies {
    implementation 'com.google.android.libraries.places:places:2.6.0'
}

Las sugerencias para autocompletar direcciones requieren una clave de API de Google Places. Sigue la guía de configuración del SDK de Google Places para generar tu clave API.

Puedes configurar el Address Element con detalles como mostrar valores predeterminados, establecer países permitidos, personalizar el aspecto, etc. Consulta AddressLauncher.Configuration para obtener la lista completa de opciones de configuración.

val addressConfiguration = AddressLauncher.Configuration(
  additionalFields: AddressLauncher.AdditionalFieldsConfiguration(
    phone: AdditionalFieldsConfiguration.FieldConfiguration.Required
  ),
  allowedCountries: setOf("US", "CA", "GB"),
  title: "Shipping Address",
  googlePlacesApiKey = "(optional) YOUR KEY HERE"
)

Recupera los datos de la dirección creando una instancia de AddressLauncher en el método del ciclo de vida onCreate de tu Activity o Fragment y creando un método de devolución de llamada que implemente la interfaz AddressLauncherResultCallback.

private lateinit var addressLauncher: AddressLauncher
private var shippingDetails: AddressDetails? = null

override fun onCreate(savedInstanceState: Bundle?) {
    addressLauncher = AddressLauncher(this, ::onAddressLauncherResult)
}

private fun onAddressLauncherResult(result: AddressLauncherResult) {
    // TODO: Handle result and update your UI
    when (result) {
        is AddressLauncherResult.Succeeded -> {
            shippingDetails = result.address
        }
        is AddressLauncherResult.Canceled -> {
            // TODO: Handle cancel
        }
    }
}

El AddressLauncherResult puede ser Succeeded o Canceled. Consulta más detalles de implementación.

Presenta el address element mediante “address launcher” y la configuración de los pasos anteriores.

addressLauncher.present(
   publishableKey = publishableKey,
   configuration = addressConfiguration
)