Coletar endereços físicos e números de telefone

Primeiro, você precisa de uma conta Stripe. Cadastre-se agora.

O SDK da Stripe para Android é de código aberto e totalmente documentado.

Para instalar o SDK, adicione stripe-android ao bloco dependencies do arquivo 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")
}

Configure o SDK com sua chave publicável da Stripe, de modo que seja possível fazer solicitações à API Stripe, como em sua subcategoria Application:

import com.stripe.android.PaymentConfiguration

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

O elemento de endereço usa o SDK do Google Places para obter sugestões de preenchimento automático de endereços. Para habilitar sugestões de preenchimento automático, você precisa incluir a dependência do SDK do Google Places no build.gradle do seu aplicativo.

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

As sugestões de preenchimento automático de endereços exigem uma chave de API do Google Places. Siga o guia de configuração do SDK do Google Places para gerar sua chave de API.

Você pode configurar o Address Element com detalhes como exibir valores padrão, definir países permitidos, personalizar a aparência e assim por diante. Consulte AddressLauncher.Configuration para obter a lista completa de opções de configuração.

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

Recupere os detalhes do endereço criando uma instância de AddressLauncher no método de ciclo de vida onCreate da sua Activity ou Fragment e criando um método de retorno de chamada que implemente a interface 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
        }
    }
}

O AddressLauncherResult pode ser Succeeded ou Canceled. Consulte mais detalhes de implementação.

Apresente o Address Element usando o iniciador de endereços e a configuração das etapas anteriores.

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