调至内容部分
创建账户
或
登录
Stripe 文档徽标
/
创建账户
登录

收集物理地址和电话号码

了解如何在移动应用中收集地址和电话号码。

要收集完整的账单地址或收货地址，请使用 Address Element。

还可以使用 Address Element 执行以下作：

Stripe 将收集的地址信息和支付方式合在一起来创建 PaymentIntent。

用户选择“添加收货地址”选项的结账流程示例。然后，他们被带到一个新的界面，将他们的收货地址添加到一个表单中（他们会在键入地址时看到自动完成建议）。

设置 Stripe
服务器端
客户端

首先，您需要有 Stripe 账户。立即注册。

Stripe Android SDK 是开源的，且有完整的文档。

安装 SDK 时，将 stripe-android 添加到您的 app/build.gradle 文件的 dependencies 块中：

build.gradle.kts
plugins {
    id("com.android.application")
}

android { ... }

dependencies {
  // ...

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

注意

有关最新 SDK 发布及过往版本的详细信息，请查看 GitHub 上的发布页面。要想在新版本发布时接收通知，请查看仓库的发布情况。

用您的 Stripe 公钥配置 SDK，以便它可以向 Stripe API 发送请求，例如在您的 Application 子类中：

import com.stripe.android.PaymentConfiguration

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

        )
    }
}

注意

测试时使用您的测试密钥，发布应用时使用真实模式密钥。

设置地址自动完成建议

Address Element 使用 Google Places SDK 来获取地址自动完成建议。要启用自动完成建议，您需要在应用的 build.gradle 中包含 Google Places SDK 依赖项。

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

地址自动完成建议需要 Google Places API 密钥。请按照 Google Places SDK 设置指南生成您的 API 密钥。

配置 Address Element

可以使用显示默认值、设置允许的国家/地区、自定义外观等详细信息来配置 Address Element。有关配置选项的完整列表，请参阅 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"
)

检索地址详情

通过在 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
)
此页面的内容有帮助吗？
是否
需要帮助？联系支持。
加入我们的早期使用计划。
查看我们的更改日志。
有问题？联系销售。
LLM? Read llms.txt.
Powered by Markdoc