调至内容部分
创建账户或登录
Stripe 文档徽标
/
询问人工智能
创建账户登录
开始
付款
销售收入
平台和交易市场
资金管理
开发人员资源
API 和 SDK帮助
概览查看所有产品
关于 API
    API 一览
    Payment Intents API
    Setup Intents API
    PaymentIntents 和 SetupIntents 如何运作
    Payment Methods API
    Payment Records API
    产品和价格
    Older API
      收款
      来源
      对比 PaymentIntent 和 Charges
Stripe 词汇表
开始构建
创建账户
快速开始
开始开发
用 LLM 构建
在无代码的情况下使用 Stripe
迁移到 Stripe
常见用例
概览作为初创公司接受简单付款作为 SaaS 初创公司销售订阅构建按用量定价的订阅解决方案线下收款发送账单以收取款项
美国
简体中文
首页开始About the APIsOlder APIs

Charges 与 Payment Intents API

了解 Stripe 的两大核心支付 API 的差别及何时使用它们。

认识 Stripe payment API

现在,在 Stripe 上收款有三种方式:

  • Stripe Checkout
  • Charges API
  • Payment Intents API

Stripe Checkout 是一个预构建的页面,可将您的客户重定向到这里,方便地完成购买和订阅。它提供了很多功能,例如 Apple Pay、Google Pay、国际化及表单验证。

Charges 和 Payment Intents API 可供您创建自定义的付款流程和使用体验。

Payment Intents API 是所有 Stripe 产品和支付方式的一体化 API。虽然我们并未弃用 Charges,但新功能只可通过 Payment Intents API 来提供。

关于完整的功能对比,请看下表:

Charges APIPayment Intents API
常由主要客户群在美国/加拿大而想用一种可接受银行卡付款的简单方式的商家使用。接受多种支付方式及银行卡需要验证的公司要求使用(例如,由于欧洲的强客户验证)。
适用于 Web、iOS 和 Android。适用于 Web、iOS 和 Android。也可用于通过 Terminal 进行店内收款。
Sources API 支持银行卡及所有支付方式。支持银行卡、需要 3DS 验证的银行卡、iDEAL、SEPA 及很多其他支付方式。
不是 SCA ready 的是 SCA ready 的

从 Charge 读取的迁移代码

如果您的应用程序涉及多个付款流程,并且想逐个从 Charges API 迁移到 Payment Intents API,则应先更新从 Charge 对象读取的代码。为帮助实现这一点,Charge 对象的两个额外属性 payment_method_details 和 billing_details 提供了可供读取收款所用的支付方式的一致界面。

所有的 API 版本以及用 Charges API 和 Payment Intents API 创建的收款对象,都可以使用这些字段。

下表显示的是一笔收款的常用属性,以及如何用其他属性访问同一信息:

描述升级前升级后
用于创建收款的支付方式的详情charge.sourcecharge.payment_method_details
收款所用支付方式的 IDcharge.source.idcharge.payment_method
所用支付方式的类型charge.source.object(例如 card 或 bank_account)charge.payment_method_details.type
收款的账单信息(例如账单邮编)charge.source.address_zipcharge.billing_details.address.postal_code
持卡人姓名charge.source.namecharge.billing_details.name
所用银行卡的后 4 位charge.source.last4charge.payment_method_details.card.last4
银行卡指纹charge.source.fingerprintcharge.payment_method_details.card.fingerprint
收款的 CVC 验证状态charge.source.cvc_checkcharge.payment_method_details.card.checks.cvc_check
银行卡品牌值charge.source.brand 可以是下列值之一:American Express, Diners Club, Discover, JCB, MasterCard, UnionPay, Visacharge.payment_method_details.card.brand 可以是下列值之一:amex, diners, discover, jcb, mastercard, unionpay, visa
Google Pay 枚举值charge.source.tokenization_method 是 android_paycharge.payment_method_details 内的 card.wallet.type 是 google_pay

另请参阅

  • 迁移到 Payment Intents
此页面的内容有帮助吗?
是否
  • 需要帮助?联系支持。
  • 查看我们的更改日志。
  • 有问题?联系销售。
  • LLM? Read llms.txt.
  • Powered by Markdoc