调至内容部分
创建账户
或
登录
Stripe 文档徽标
/
询问人工智能
创建账户
登录
开始
付款
销售收入
平台和交易市场
资金管理
开发人员工具
概览
关于 Stripe 支付
升级您的集成
支付分析
线上付款
概览查找您的用例Managed Payments
使用 Payment Link
构建结账页面
构建高级集成
构建应用内集成
    概览
    支付表单
    嵌入式 Payment Element
    应用内购买外部链接
    收集地址
    美国和加拿大卡
支付方式
添加支付方式
管理支付方式
用 Link 更快结账
支付接口
Payment Links
结账
Web Elements
应用内 Element
支付场景
自定义支付流程
灵活收单
编排
线下支付
Terminal
其他 Stripe 产品
Financial Connections
加密货币
Climate
首页付款Build an in-app integration

收集物理地址和电话号码

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

复制页面

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

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

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

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

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

设置 Stripe
服务器端
客户端

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

React Native SDK 是开源的并且配备了完整的文档。在内部,它使用原生 iOS 和 Android SDK。要安装 Stripe 的 React Native SDK,请在项目的目录中运行以下命令之一(具体取决于您使用的软件包管理器):

Command Line
yarn add @stripe/stripe-react-native

然后,安装一些其他必要的依赖项:

  • 对于 iOS,导航到 ios 目录并运行 pod install 以确保您也安装了所需的原生依赖项。
  • 对于 Android,您无需安装更多依赖项。

Stripe 初始化

要在您的 React Native 应用中初始化 Stripe,使用 StripeProvider 组件包裹您的支付界面,或者使用 initStripe 初始化方法。只需要 publishableKey 中的 API 公钥。下例显示的是用 StripeProvider 组件初始化 Stripe 的方式。

import { StripeProvider } from '@stripe/stripe-react-native'; function App() { return ( <StripeProvider publishableKey=
"pk_test_TYooMQauvdEDq54NiTphI7jx"
> // Your app code here </StripeProvider> ); }

注意

测试与开发时使用 API 测试模式,发布时使用真实模式密钥。

设置地址自动完成建议

在 iOS 上,自动完成功能默认启用,但要在 Android 上启用自动完成建议,您需要在应用的 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

您可以对 Address Element 进行配置,例如显示默认值、设置允许的国家/地区、定制外观等详细设置。有关更多信息,请参阅可用选项列表。

<AddressSheet appearance={{ colors: { primary: '#F8F8F2', background: '#272822' } }} defaultValues={{ phone: '111-222-3333', address: { country: 'United States', city: 'San Francisco', }, }} additionalFields={{ phoneNumber: 'required', }} allowedCountries={['US', 'CA', 'GB']} primaryButtonTitle={'Use this address'} sheetTitle={'Shipping Address'} googlePlacesApiKey={'(optional) YOUR KEY HERE'} />

显示 Address Element 并检索详细信息

通过将 visible 属性设置为 true 并为 onSubmit 和 onError 属性添加回调方法来检索地址详细信息:

<AddressSheet visible={true} onSubmit={async (addressDetails) => { // Make sure to set `visible` back to false to dismiss the address element. setAddressSheetVisible(false); // Handle result and update your UI }} onError={(error) => { if (error.code === AddressSheetError.Failed) { Alert.alert('There was an error.', 'Check the logs for details.'); console.log(err?.localizedMessage); } // Make sure to set `visible` back to false to dismiss the address element. setAddressSheetVisible(false); }} />

可选在 Payment Element 中预填充收货地址

可选自定义外观

可选设置默认账单详情

可选自定义账单地址信息的收集

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