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

收集物理地址和电话号码

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

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

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

  • 收集客户电话号码
  • 使用自动完成功能（在 iOS 中默认启用）
  • 通过传入收货地址在 Payment Element 中预填充账单信息

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

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

设置 Stripe
服务器端
客户端

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

Stripe iOS SDK 是开源的，有完整的文档，并且与支持 iOS 13 或更高版本操作系统的应用程序兼容。

要安装 SDK，按这些步骤进行：

  1. 在 Xcode 中，选择文件 > **添加工具包依赖…**并输入 https://github.com/stripe/stripe-ios-spm 作为仓库 URL。
  2. 从我们的发布页面选择最新的版本号。
  3. 将 StripePaymentSheet 产品添加到您的目标应用程序。

注意

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

在应用程序启动时使用您的 Stripe 公钥 配置 SDK。这样可使您的应用程序向 Stripe API 发出请求。

AppDelegate.swift
import UIKit
import StripePaymentSheet

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        StripeAPI.defaultPublishableKey = 
"pk_test_TYooMQauvdEDq54NiTphI7jx"

        // do any other necessary launch configuration
        return true
    }
}

注意

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

设置地址自动完成建议

iOS 系统会默认启用自动完成功能。

配置 Address Element

可以使用显示默认值、设置允许的国家/地区、自定义外观等详细信息来配置 Address Element。有关配置选项的完整列表，请参阅 AddressViewController.Configuration。

let addressConfiguration = AddressViewController.Configuration(
  additionalFields: .init(phone: .required),
  allowedCountries: ["US", "CA", "GB"],
  title: "Shipping Address"
)

检索地址详情

通过满足 AddressViewControllerDelegate 并使用 addressViewControllerDidFinish 关闭视图控制器来检索地址详细信息。地址的值是有效的地址或空。

extension MyViewController: AddressViewControllerDelegate {
    func addressViewControllerDidFinish(_ addressViewController: AddressViewController, with address: AddressViewController.AddressDetails?) {
        addressViewController.dismiss(animated: true)
        self.addressDetails = address
    }
}

显示 Address Element

使用以上步骤中的地址配置和委托创建 AddressViewController。您可以将其显示在导航控制器中，也可以将其推送到导航控制器上。

self.addressViewController = AddressViewController(configuration: addressConfiguration, delegate: self)
let navigationController = UINavigationController(rootViewController: addressViewController)

present(navigationController, animated: true)
此页面的内容有帮助吗？
是否
需要帮助？联系支持。
加入我们的早期使用计划。
查看我们的更改日志。
有问题？联系销售。
LLM? Read llms.txt.
Powered by Markdoc