住所の入力をリッスンする

イベントリスナーを使用して、カスタマイズされた方法で使用できるように住所を収集します。

ウェブ

iOS

Android

React Native

Address Element を使用して、顧客の国内および国外の住所を収集します。

ユーザーが「配送先住所を追加」オプションを選択した場合の決済フロープロセスの例。ユーザーは新しい画面に誘導され、ここでフォームに配送先住所を入力します。住所を入力すると、オートコンプリート機能によってユーザーに選択肢が表示されます。

Stripe を設定する

まず、Stripe アカウントが必要です。今すぐ登録してください。

Stripe Android SDK はオープンソースであり、詳細なドキュメントが提供されています。

To install the SDK, add stripe-android to the dependencies block of your app/build.gradle file:

build.gradle
Groovy
apply plugin: 'com.android.application'

android { ... }

dependencies {
  // ...

  // Stripe Android SDK
  implementation 'com.stripe:stripe-android:21.2.0'
}

注

SDK の最新リリースおよび過去バージョンの詳細については、GitHub の Releases ページをご覧ください。新しいリリースの公開時に通知を受け取るには、リポジトリのリリースを確認してください。

Stripe の公開可能キーを使用して SDK を設定し、 Application サブクラスなどで、Stripe API へのリクエストを実行できるようにします。

注

テストおよび開発時にはテスト環境のキーを使用し、アプリを公開する際に本番環境のキーを使用します。

オプション住所のオートコンプリートの入力候補を設定する

Address Element は、Google Places SDK を使用して、住所のオートコンプリートの入力候補を取得します。オートコンプリートの入力候補を有効にするには、アプリの build.gradle に Google Places SDK の依存関係を含める必要があります。

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

住所のオートコンプリートの入力候補を使用するには、Google Places API キーが必要です。Google Places SDK 設定ガイドに従って API キーを生成します。

Address Element を設定する

You can configure the Address Element with details such as displaying default values, setting allowed countries, customizing the appearance, and so on. Refer to AddressLauncher.Configuration for the complete list of configuration options.

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

住所の詳細を取得する

住所の詳細を取得するには、Activity または Fragment の onCreate ライフサイクルメソッドで AddressLauncher のインスタンスを作成して、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
        }
    }
}

AddressLauncherResult は Succeeded または Canceled になります。実装の詳細をご覧ください。

注

Stripe では、onCreate ライフサイクルイベントの間 (イベント後ではなく) に AddressLauncher をインスタンス化する必要があります。これを行わない場合、コールバックを正しく登録できず、アプリがクラッシュします。

Address Element を表示する

前のステップの住所ランチャーと設定を使用して、Address Element を表示します。

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

注