Passa al contenuto
Crea account
 o
Accedi
Il logo della documentazione Stripe
/
Crea un account
Accedi
PanoramicaEseguire l'upgrade dell'integrazione
Pagamenti online
PanoramicaTrovare il caso d'uso più adattoManaged Payments
Metodi di pagamento
Interfacce di pagamento
Scenari di pagamento
Pagamenti di persona
Oltre i pagamenti

Raccogliere gli indirizzi fisici e i numeri di telefono

Come raccogliere indirizzi e numeri di telefono nell'app mobile

Per raccogliere indirizzi completi per la fatturazione o la spedizione, utilizza Address Element.

Puoi utilizzare Address Element anche per:

Stripe combina le informazioni raccolte sull’indirizzo e sul metodo di pagamento per creare un PaymentIntent.

Esempi di una procedura di pagamento in cui un utente seleziona l'opzione Aggiungi indirizzo di spedizione. Poi l'utente viene indirizzato a una nuova schermata per aggiungere l'indirizzo di spedizione in un modulo. Mentre digita l'indirizzo, può scegliere tra i suggerimenti di completamento automatico.

Configura Stripe
Lato server
Lato client

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:

build.gradle.kts
Kotlin
Groovy
No results
plugins {
    id("com.android.application")
}

android { ... }

dependencies {
  // ...

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

Nota

Per ulteriori informazioni sulla versione più recente e su quelle precedenti dell’SDK, consulta la pagina Releases su GitHub. Per ricevere una notifica quando viene pubblicata una nuova versione, imposta il controllo delle versioni per il repository.

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:

Kotlin
Java
No results
import com.stripe.android.PaymentConfiguration

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

        )
    }
}

Nota

Usa le chiavi di test durante i test e le chiavi della modalità live quando pubblichi l’app.

Impostare i suggerimenti di completamento automatico dell'indirizzo

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.

build.gradle
Groovy
Kotlin
No results
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.

Configurare Address Element

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"
)

Recuperare i dati relativi all'indirizzo

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.

Nota

Stripe richiede di creare un’istanza di AddressLauncher durante l’evento del ciclo di vita onCreate e non dopo. In caso contrario, il callback non potrà essere registrato correttamente e l’app si arresterà in modo anomalo.

Presentare Address Element

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

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

FacoltativoPrecompilare gli indirizzi di spedizione in Payment Element

Se utilizzi Payment Element per dispositivi mobili, imposta PaymentSheet.Configuration.shippingDetails sull’indirizzo raccolto da Address Element. Quando shippingDetails viene compilato, l’indirizzo di fatturazione degli utenti viene precompilato e viene visualizzata una casella di controllo L’indirizzo di fatturazione è uguale all’indirizzo di spedizione. I Payment Intent confermati con shippingDetails compilato hanno anche la proprietà d’intenzione shipping compilata al momento della conferma del Payment Intent.

val configuration = PaymentSheet.Configuration.Builder("Example, Inc.")
  // ...
  .shippingDetails(shippingDetails)
  .build()

FacoltativoPersonalizza l'aspetto

Ora che hai aggiunto il componente Address Element alla tua app, puoi personalizzarne l’aspetto per adattarlo al design del resto della tua app. Puoi configurare l’aspetto con l’API Appearance utilizzando AddressLauncher.Configuration.appearance.

FacoltativoImpostare i dati di fatturazione predefiniti

Per impostare i valori predefiniti per i dettagli di addebito raccolti nella scheda di pagamento, configura la proprietà defaultBillingDetails. PaymentSheet precompila i campi della scheda con i valori che fornisci.

Kotlin
Java
No results
val address = PaymentSheet.Address(country = "US")
val billingDetails = PaymentSheet.BillingDetails(
  address = address,
  email = "foo@bar.com"
)
val configuration = PaymentSheet.Configuration.Builder(merchantDisplayName = "Merchant, Inc.")
  .defaultBillingDetails(billingDetails)
  .build()

FacoltativoPersonalizzare la raccolta dei dati per gli addebiti

Configura la raccolta dei dati di fatturazione

Utilizza BillingDetailsCollectionConfiguration per specificare la modalità di raccolta dei dati di fatturazione nel PaymentSheet.

Puoi acquisire il nome, l’indirizzo email, il numero di telefono e l’indirizzo del cliente.

Se vuoi associare i dati di fatturazione predefiniti all’oggetto PaymentMethod anche quando tali campi non sono raccolti nell’interfaccia utente, imposta billingDetailsCollectionConfiguration.attachDefaultsToPaymentMethod su true.

Kotlin
Java
No results
val billingDetails = PaymentSheet.BillingDetails(
  email = "foo@bar.com"
)
val billingDetailsCollectionConfiguration = BillingDetailsCollectionConfiguration(
  attachDefaultsToPaymentMethod = true,
  name = BillingDetailsCollectionConfiguration.CollectionMode.Always,
  email = BillingDetailsCollectionConfiguration.CollectionMode.Never,
  address = BillingDetailsCollectionConfiguration.AddressCollectionMode.Full,
)
val configuration = PaymentSheet.Configuration.Builder(merchantDisplayName = "Merchant, Inc.")
  .defaultBillingDetails(billingDetails)
  .billingDetailsCollectionConfiguration(billingDetailsCollectionConfiguration)
  .build()

Nota

Rivolgiti al tuo consulente legale per sapere quali sono le leggi applicabili alla raccolta di informazioni. Richiedi i numeri di telefono solo se necessari per la transazione.

Questa pagina è stata utile?
SìNo