Raccogliere gli indirizzi fisici e i numeri di telefono

Innanzitutto, devi creare un account Stripe. Registrati ora.

L’SDK per Android di Stripe è open source e completamente documentato.

Per installare l’SDK, aggiungi stripe-android al blocco dependencies del tuo file app/build.gradle:

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

android { ... }

dependencies {
  // ...

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

Configura l’SDK con la tua chiave pubblicabile di Stripe in modo che possa inviare le richieste all’API Stripe, ad esempio nella sottoclasse Application:

import com.stripe.android.PaymentConfiguration

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

Address Element utilizza Google Places SDK per recuperare i suggerimenti di completamento automatico dell’indirizzo. Per abilitare i suggerimenti di completamento automatico, devi includere la dipendenza di Google Places SDK nel file build.gradle dell’app.

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

I suggerimenti di completamento automatico dell’indirizzo richiedono una chiave API Google Places. Segui la guida alla configurazione di Google Places SDK per generare la tua chiave API.

Puoi configurare Address Element con informazioni quali la visualizzazione dei valori predefiniti, l’impostazione dei Paesi consentiti, la personalizzazione dell’aspetto e così via. Per l’elenco completo delle opzioni di configurazione, fai riferimento a AddressLauncher.Configuration.

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 i dettagli dell’indirizzo creando un’istanza di AddressLauncher nel metodo del ciclo di vita onCreate di Activity o Fragment e creando un metodo di callback che implementi l’interfaccia 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
        }
    }
}

Lo stato del parametro AddressLauncherResult può essere Succeeded or Canceled. Scopri di più sui dettagli dell’implementazione.

Presenta l’Address Element utilizzando l’utilità di avvio degli indirizzi e la configurazione dei passaggi precedenti.

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