调至内容部分
创建账户
或
登录
Stripe 文档徽标
/
询问人工智能
创建账户
登录
开始
付款
财务自动化
平台和交易市场
资金管理
开发人员工具
开始
付款
财务自动化
开始
付款
财务自动化
平台和交易市场
资金管理
概览探索所有产品
开始构建
开始开发
项目示例
关于 API
    API 一览
    Payment Intents API
    Setup Intents API
    支付方式
    产品和价格
    Older API
      收款
      来源
        迁移到新的 API
        银行卡 Sources
        Source 和 Customer
        按 ACH 直接借记额收取
        Connect 平台
        最佳实践
        iOS
        Android
    发布阶段
Build with LLMs
在无代码的情况下使用 Stripe
设置 Stripe
创建账户
网页端管理平台
移动端管理平台
迁移到 Stripe
管理欺诈风险
了解欺诈
Radar 欺诈保护
管理争议
验证身份
首页开始About the APIsOlder APIsSources

Source 和 Customer已废弃

了解如何用 Customer 对象绑定和管理 Source

警告

We deprecated the Sources API and plan to remove support for local payment methods. If you currently handle any local payment methods using the Sources API, you must migrate them to the Payment Methods API.

While we don’t plan to remove support for card payments, we recommend replacing any use of the Sources API with the PaymentMethods API, which provides access to our latest features and payment method types.

Source 对象可以一次性使用或重复使用,具体由它的 usage 参数来指示。虽然可以对 Source 直接扣款,但始终应将_可重复使用_的 Source 绑定到 Customer 对象才能供以后重复使用。将可重复使用的 Source 绑定到 Customer 对象后,您便可以向客户展示他们之前在您的应用或网站中使用过的可重复使用的支付方式列表。

可重复使用的来源

某些支付方式(例如 SEPA 直接借记)支持可重复使用的 Source,因此您可以在客户无需再次完成付款流程的情况下创建额外的付款。可重复使用的 Source 的 usage 参数会设置为 reusable。

必须将可重复使用的来源绑定到 Customer 对象后才能创建收款请求。如果您在未事先绑定某个可重复使用的 Source 的情况下对它扣款,那么这个来源就被消耗了(状态从 chargeable 变为 consumed)。消耗的来源不能用于再次付款。

将某个来源绑定到新的 Customer 对象

您可以创建一个 Customer 对象,并在一个 API 调用中绑定来源。如果您是第一次看到此客户,则这种方式比较有用。

Command Line
cURL
curl https://api.stripe.com/v1/customers \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ --data-urlencode email="paying.user@example.com" \ -d source=src_18eYalAHEMiOZZp1l9ZTjSU0

该 Source 会变成 Customer 对象的默认 Source,因为它是此客户的第一个也是仅有的支付方式。如果您在不指定 source 的情况下使用 customer 参数创建收款请求,则会自动选择默认 Source。

将某个 Source 绑定到现有的 Customer 对象

更新一个有默认 Source 的 Customer 对象时,会自动解绑现有 Source,并将提供的 Source 添加为新的默认 Source。要在不替换现有默认 Source 的情况下添加 Source,应使用 attach 方法,如下所示。

Command Line
curl
curl https://api.stripe.com/v1/customers/cus_AFGbOSiITuJVDs/sources \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d "source"="src_18eYalAHEMiOZZp1l9ZTjSU0"

这里,由于 Customer 对象可能已经存在一个默认的来源,新绑定的来源尚未变成默认来源。但是,可以通过更新 Customer 对象并将来源指定为 default_source 来更改默认来源。

Command Line
cURL
curl https://api.stripe.com/v1/customers/cus_AFGbOSiITuJVDs \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d default_source=src_18eYalAHEMiOZZp1l9ZTjSU0

对绑定的来源扣款

创建收款请求时,必须同时指定 Customer 对象和来源。

Command Line
curl
curl https://api.stripe.com/v1/charges \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d amount="1099" \ -d currency="eur" \ -d customer=cus_AFGbOSiITuJVDs \ -d source=src_18eYalAHEMiOZZp1l9ZTjSU0

如果试图在不指定来源的情况下对 Customer 对象扣款,则 Stripe 会使用客户的默认来源。

解绑来源

如需移除某个特定 Customer 对象的来源,可以解绑来源。这样做会将来源的状态更改为 consumed,解绑后不能再使用。

一次性使用的来源

对于一次性使用的来源,客户每次付款时都要创建,而且不能重复使用。因此,不建议将其永久绑定到客户。

如果想将某笔付款关联到特定的 Customer 对象,则可以在用某个来源创建收款请求时包含 customer 参数,即使此来源未绑定。

Command Line
curl
curl https://api.stripe.com/v1/charges \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d amount="1099" \ -d currency="eur" \ -d customer=cus_AFGbOSiITuJVDs \ -d source=src_18eYalAHEMiOZZp1l9ZTjSU0

相应 Charge 对象会同时引用 Customer 和 Source 这两个对象,即使可能二者并不直接相关。

另见

  • Sources 上支持的支付方式
  • 使用 Source 的最佳实践
  • 克隆保存的支付方式
  • Sources API 参考
此页面的内容有帮助吗?
是否
需要帮助?联系支持。
加入我们的早期使用计划。
查看我们的更改日志。
有问题?联系销售。
LLM? Read llms.txt.
Powered by Markdoc