调至内容部分
创建账户
或
登录
Stripe 文档徽标
/
询问人工智能
创建账户
登录
开始
付款
销售收入
平台和交易市场
资金管理
开发人员资源
概览查看所有产品
开始构建
开始开发
关于 API
    API 一览
    Payment Intents API
    Setup Intents API
    PaymentIntents 和 SetupIntents 如何运作
    Payment Methods API
    产品和价格
    发布阶段
用 LLM 构建
在无代码的情况下使用 Stripe
设置 Stripe
创建账户
Stripe 管理平台
迁移到 Stripe
首页开始About the APIs

Setup Intents API

更多地了解任何用 Setup Intents API 保存支付方式。

用 Setup Intents API 设置一个用于未来付款的支付方式。它与付款类似,但不用创建收款。立即设置用于未来付款的支付方式。

目标是保存支付证书,并为未来付款进行优化,也就是为任何支付场景正确配置支付方式。以设置银行卡为例,可能有必要通过客户的银行验证客户或检查卡的有效性。Stripe 在整个过程中更新 SetupIntent 对象。

UI 收集银行卡详细信息,但不从卡中扣款

保存并重新使用支付方式

Setup Intents API 尤其适用于那些入驻了客户但不立即对其扣款的公司:

  • 一家汽车租赁公司,在客户租车前收集支付方式详情,租期结束后再对银行卡扣款。
  • 一个众筹网站,先收集银行卡信息,之后活动达到某一特定金额时才扣款。
  • 一家公用事业公司,每月根据用量扣取不同金额,但是要在第一个月付款前收集 SEPA 支付信息。

注意

您也可以用 Checkout 设置供未来使用的支付方式。

开始

  • 不预先扣款的情况下保存银行卡
  • 保存银行详情用于 SEPA 直接借记付款
  • 保存银行详情用于 BECS 直接借记付款

获取保存支付方式的许可

合规

在保存客户的支付详情时,您需要负责遵守所有适用的法律、法规和卡组织规则。如果您为未来的会话内付款设置某种支付方式,例如在未来的结账页面上显示支付方式,则务必要明确取得客户就这一特定用途的同意书。例如,包含“保存我的支付方式以供未来使用”复选框以收集用户同意书。如果需要区分仅供离线使用的支付方式和可以向客户显示的供未来会话内购物使用的支付方式,则可以使用 PaymentMethod 对象上的 allow_redisplay 参数。

如果您设置一个支付方式用于未来的会话外付款,则您需要获得许可。事先制作一份协议(有时候叫做_授权_)后您便可以在客户不经常使用您的网站或应用的情况对其进行扣款。

在您的网站或应用中添加条款,陈明您计划如何处理付款,并让客户同意加入。条款中至少要包含以下几点:

  • 客户给予您代其发起一次或一系列付款的许可
  • 预计的付款频率(即一次性或经常性)
  • 如何确定付款金额

请查看针对保存银行卡或保存 SEPA 银行详情推荐的授权文本。

对于受 SCA 影响的用户,该协议可确保付款顺利成功。在您设置了您的集成可以正确保存银行卡之后,Stripe 会将后续的任何会话外付款标为商家发起的交易 (MIT),这样客户便不需要再回到线上并进行验证了。处理商家发起的交易时需要有您与客户之间签订的协议

指明使用方式,增大成功率

usage 参数用于告知 Stripe 您今后计划如何使用保存的支付方式详情。对于某些支付方式,Stripe 可利用您的 usage 设置为客户选取最顺畅的流程。这种优化旨在增加成功付款的次数。

例如,欧洲的 SCA 规范监管下的信用卡和借记卡可能需要客户在保存过程中对银行卡进行验证。将 usage 设置为 off_session,可为会话外付款正确验证信用卡或借记卡,客户便可以不回到线上再重新验证。虽然在最初的设置流程中会带来一些阻力,但是将 usage 设置为 off_session 可让客户在后续的会话外付款时更加轻松。

但是,如果您只计划在客户结账时用卡,则将 usage 设置为 on_session。这样银行就会知道您只会在客户能够进行验证的时才使用银行卡,因此您可以将银行卡详情的验证推迟到此时候,避免前期造成的阻力。

您打算如何用卡要使用的用法枚举值
仅会话内付款on_session
仅会话外付款off_session(默认)
会话内与会话外这两种付款方式off_session(默认)

Usage 是一种优化措施。您仍然可以使用已设置为会话内支付的卡片来进行会话外支付,但银行更有可能拒绝会话外支付并要求客户进行身份验证。无论哪种情况,都可能会要求后续的身份验证,因此建议在您的应用中构建一个恢复流程。当会话外卡支付需要身份验证时,让您的客户重新上线完成支付。

如果未指定,则 usage 默认为 off_session。查看如何在您的服务器上创建 SetupIntent 并指定 usage:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/setup_intents \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d usage=on_session

注意

请按照该页的指南操作,确保您的集成能够处理要求强客户认证的银行卡。正确标记交易有助于 Stripe 代您正确申请 SCA 豁免,将每笔付款的验证要求降到最低。

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