Physische Adressen und Telefonnummern erfassen

Zunächst benötigen Sie ein Stripe-Konto. Registrieren Sie sich jetzt.

Das Stripe Android SDK ist Open Source und vollständig dokumentiert.

Um das SDK zu installieren, fügen Sie stripe-android in den Block dependencies Ihrer app/build.gradle-Datei ein:

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

Konfigurieren Sie das SDK mit Ihrem veröffentlichbaren Schlüssel von Stripe so, dass dieser Anfragen an die API stellen kann, wie beispielsweise in Ihrer Unterklasse Application:

import com.stripe.android.PaymentConfiguration

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

Das Adresselement verwendet das Google Places SDK, um Vorschläge zur automatischen Vervollständigung von Adressen abzurufen. Um die Vorschläge zur automatischen Vervollständigung zu aktivieren, müssen Sie die Google Places SDK-Abhängigkeit in die build.gradle-Datei Ihrer App einbinden.

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

Für Vorschläge zur automatischen Vervollständigung von Adressen ist ein Google Places-API-Schlüssel erforderlich. Befolgen Sie die Einrichtungsanleitung für das Google Places SDK, um Ihren API-Schlüssel zu generieren.

Sie können das Address Element mit Details wie der Anzeige von Standardwerten, der Festlegung zulässiger Länder, der Anpassung des Erscheinungsbilds usw. konfigurieren. Eine vollständige Liste der Konfigurationsoptionen finden Sie unter 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"
)

Rufen Sie die Adressdetails ab, indem Sie eine Instanz von AddressLauncher in der Lebenszyklusmethode onCreate Ihrer Activity oder Ihres Fragment erstellen und eine Callback-Methode erstellen, die die AddressLauncherResultCallback-Schnittstelle implementiert.

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
        }
    }
}

Das AddressLauncherResult kann Succeeded oder Canceled sein. Hier finden Sie weitere Details zur Implementierung.

Präsentieren Sie das Adresselement mit dem Adress-Launcher und der Konfiguration aus den vorherigen Schritten.

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