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

Primero, necesitas una cuenta de Stripe. Regístrate ahora.

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

Para instalar el SDK, añade 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 elemento dirección utiliza el SDK de Google Places para obtener sugerencias de autocompletado de direcciones. Para habilitar las sugerencias de autocompletado, debes incluir la dependencia del SDK de Google Places en el archivo 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 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 la visualización de los valores predeterminados, la configuración de los países permitidos, la personalización de la apariencia, 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 de 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 con el lanzador de direcciones y la configuración de los pasos anteriores.

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