Collecter les adresses physiques et les numéros de téléphone

Pour commencer, vous devez créer un compte Stripe. Inscrivez-vous maintenant.

Le SDK Stripe Android est disponible en open source et fait l’objet d’une documentation complète.

Pour installer le SDK, ajoutez stripe-android au bloc dependencies de votre fichier 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")
}

Configurez le SDK avec votre clé publique Stripe de façon à ce qu’il puisse envoyer des requêtes à l’API Stripe, par exemple à la sous-classe Application :

import com.stripe.android.PaymentConfiguration

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

L’Address Element utilise le SDK Google Places pour récupérer les suggestions de remplissage automatique de l’adresse. Pour activer les suggestions de remplissage automatique, vous devez inclure la dépendance du SDK Google Places au build.gradle de votre application.

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

Les suggestions de saisie semi-automatique d’adresse nécessitent une clé API Google Places. Suivez le guide de configuration du SDK Google Places pour générer votre clé API.

Vous pouvez configurer l’Address Element en ajoutant des détails tels que l’affichage des valeurs par défaut, la définition des pays autorisés, la personnalisation de l’apparence, etc. Reportez-vous à AddressLauncher.Configuration pour consulter la liste complète des options de 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"
)

Récupérez les détails de l’adresse en créant une instance AddressLauncher dans la méthode de cycle de vie onCreate de votre Activity ou Fragment, et en créant une méthode de rappel déployant l’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
        }
    }
}

Le paramètre AddressLauncherResult peut être à l’état Succeeded ou Canceled. En savoir plus sur les détails de déploiement

Présentez l’Address Element à l’aide du lanceur d’adresses et de la configuration des étapes précédentes.

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