先按用途区分两类地址
账单地址与包裹目的地回答的是不同问题。Stripe 为托管结账中的两类地址分别提供收集控制。[1] 修改账单设置之前,先确认订单是否需要配送地址。要求填写账单信息,并不是文档规定的收货地址收集开关。[1][2]
一则公开开发者提问描述了把客户地址带入结账会话的困难,所附代码已经设置 billing_address_collection: 'required'。[3] 这证明存在具体集成疑问,但不代表搜索量。本指南处理地址用途与配送国家选择,不讨论客户邮箱编辑,也不重复发票税务地址修复流程。
明确账单地址的收集要求
创建接口中,billing_address_collection 默认为 auto,仅在必要时收集账单地址;启用自动税额计算时,收集的是计算所需的最少字段。设置为 required,才会始终收集账单地址。[2] 因此,自动模式下表单较短,不应被诊断为收货信息丢失。
编辑建议:分别记录为什么需要账单地址、为什么需要配送目的地。纯数字商品应先评估是否有配送需求;实物订单则应明确启用收货信息收集,即使付款人通常就是收件人。不要为了满足内部账单字段,让客户虚构一个无实际用途的收货地址。
收货地址必须配合明确的国家列表
创建会话时提供 shipping_address_collection,才是文档规定的收货地址收集方式。其子字段 allowed_countries 为必填,内容是两个字母的国家代码,用于决定结账页面提供哪些配送目的地选项。[1][4] 托管页面指南示例采用 US 与 CA,并不是要求所有商户都开放美国和加拿大。[1]
假设某商户只在加拿大境内配送,其目标配置是 shipping_address_collection.allowed_countries = ['CA']。只有另有账单信息要求时,再设置 billing_address_collection = 'required'。这只是配置片段,不是完整请求,也不是已执行测试。应由获批的配送政策生成列表,并对照当前接口支持的枚举值检查代码。
配送国家不是付款人的国家限制
接口把这些代码定义为配送地点选项,而不是账单国家或发卡国家过滤器。[4] 因此,付款人与收件人位于不同国家时,应判断包裹能否送达,而不是默认两类地址必须一致。不要把这个设置解释为对居住地、国籍或购买资格的验证。
编辑建议:承运范围、商品限制、海关审查及地区销售政策应分别管理。国家出现在下拉选项中,不等于这些条件已获批准。如果配送还取决于邮编、偏远地区或商品种类,应另行核查;国家列表不能替代完整的配送政策。本指南也不据此推断 Stripe 在任何市场的商户账户可用性。
保留本次订单选择的配送目的地
托管地址指南说明,会话完成后,收集的地址保存在 shipping_details 中,并包含在 checkout.session.completed 事件载荷内;支付详情页面也可查看配送信息。[1] 这应作为文档起点,而非跳过版本核查的理由。接入生产提取逻辑之前,应核对实际固定接口版本返回的字段结构。
编辑建议:保存订单专属的目的地快照和对应会话标识,不要随后用客户记录中碰巧存在的地址静默覆盖。缺少目的地,或目的地不符合订单配送规则时,应进入纠正流程。收集到地址本身不等于可以发货;支付准备状态与履约授权仍需单独判断。排查配置问题时,也不必把完整客户地址写入普通诊断日志。
检查业务决策,而不只是表单外观
建议的验收场景包括:比较自动与必填账单地址模式;创建仅允许一个获批国家的配送会话;检查目的地选项;完成允许目的地的场景;依据实际接口版本检查返回地址。还应覆盖账单与配送国家不同,以及完全不需要配送的订单。这些都是待执行检查,不是本文报告的测试结果。
建议在上线清单中列明每个场景的预期结果、负责核查的人,以及不符合配送政策时由谁联系客户。订单目的地变更应保留原值、变更原因与批准记录,不要只修改客户资料后假定旧订单也已获得新授权。这些是商户侧的管理建议,不是 Stripe 自动提供的审批功能。
对于收件人与付款人不同的订单,客服应分别询问哪一项需要更正,避免把账单地址更正误操作为包裹改寄。若配送政策调整,应由业务负责人确认新列表及生效范围,再交由工程团队检查实际会话,而不是由客服临时添加国家来绕过限制。
没有出现收货表单时,先检查服务端创建会话的参数;缺少某个国家时,先对照配置列表与已批准的配送政策,不要为了通过表单就任意扩大范围。资料于 2026 年 9 月 23 日获取,来源未说明的发布日期仍为未知。本文属于公开资料研究与编辑操作建议,不是 PayIn 功能承诺、真实账户测试或法律及税务意见。
来源与日期
官方文档用于核对产品行为,社区问题仅说明具体需求,不代表普遍程度。检索日期为 2026-09-23,检索日期不等于发布日期。本文是文档研究,不是实际账户测试、PayIn 功能声明或金融建议。地区可用性和账户资格须另行确认。
- [1] 收集实体地址 · 发布日期未注明;更新日期未注明;核查:2026-09-23。
- [2] 创建结账会话 · 发布日期未注明;更新日期未注明;核查:2026-09-23。
- [3] 如何在结账会话中获取账单地址 · 发布:2022-01-25;更新日期未注明;核查:2026-09-23。
- [4] 创建结账会话:收货地址收集 · 发布日期未注明;更新日期未注明;核查:2026-09-23。