收款
安全地在线上收款。
制作支付表单或使用预构建的结账页面来开始接收线上付款。
使用 Stripe Checkout 在您的网站上嵌入预构建的支付表单。看看这个集成与 Stripe 的其他集成类型的对比情况。


使用 Stripe 管理平台中的品牌设置匹配 Checkout 与您的网站设计。
首先,注册一个 Stripe 账户。
用我们的官方库从您的应用程序访问 Stripe API:
创建一个 Checkout Session服务器端
从您的服务器创建一个 Checkout Session,并将 ui_mode 设置为 embedded
。您可以使用 line items 配置 Checkout Session,以包括诸如 currency 之类的选项。
您还可以为现有客户创建 Checkout Session,从而用已知联系信息预填 Checkout 字段,并统一该客户的购买记录。
要让客户返回到您网站上托管的自定义页面,请在 return_url 参数中指定该页面的 URL。在 URL 中包含 {CHECKOUT_
模板变量,以在返回页面上检索会话的状态。在重定向之前,Checkout 会自动将变量替换为 Checkout Session ID。
创建 Checkout Session 后,使用挂载 Checkout 响应中返回的 client_
。
挂载 Checkout客户端
Checkout 在 iframe 中呈现,该 iframe 通过 HTTPS 连接将支付信息安全地发送给 Stripe。
常见错误
避免将 Checkout 放在另一个 iframe 中,因为有些支付方式需要重定向到另一个页面进行付款确认。
自定义外观
通过在您账户的品牌设置中设置背景颜色、按钮颜色、边框半径和字体,自定义 Checkout 以匹配您的网站设计。
默认情况下,Checkout 在呈现时没有外部填充或边距。我们建议使用一个容器元素,如 div,来应用您想要的边距(例如,所有边都是 16px)。
显示返回页面
在您的客户尝试付款后,Stripe 会将他们重定向到您网站上的返回页面。创建 Checkout Session 时,您在 return_url 参数中指定返回页面的 URL。阅读有关自定义重定向行为其他选项的更多信息。
在呈现您的返回页面时,使用 URL 中的 Checkout Session ID 来检索 Checkout Session 的状态。根据会话状态处理结果,如下所示:
complete
: 付款成功。使用来自 Checkout Session 的信息来呈现成功页面。open
: 付款失败或被取消。重新安装 Checkout,以便您的客户可以重试。
const session = await fetch(`/session_status?session_id=${session_id}`) if (session.status == 'open') { // Remount embedded Checkout } else if (session.status == 'complete') { // Show success page // Optionally use session.payment_status or session.customer_email // to customize the success page }
基于重定向的支付方式
在支付过程中,一些支付方式会将客户重定向到中间页面,如银行授权页面。当他们完成该页面时,Stripe 会将他们重定向到您的返回页面。
了解有关基于重定向的支付方式和重定向行为的更多信息。
处理付款后事件
当客户完成 Checkout Session 付款时,Stripe 会发送一个 checkout.session.completed 事件。使用管理平台 Webhook 工具或按照 Webhook 指南接收和处理这些事件,这可能会触发您:
- 向客户发送订单确认邮件。
- 在数据库中记录销售情况。
- 启动配送流程。
请侦听这些事件而非等待客户被重定向回您的网站。仅依赖 Checkout 着陆页触发履约是不可靠的。设置您的集成来侦听异步事件,这样才能用单一集成接受不同类型的支付方式。
详情请参阅我们的 Checkout 履约指南。
使用 Checkout 收款时需处理以下事件:
活动 | 描述 | 行动 |
---|---|---|
checkout.session.completed | 当客户成功完成 Checkout Session 时发送。 | 向客户发送订单确认,并履行他们的订单。 |
checkout.session.async_payment_succeeded | 当使用延迟型支付方式(如 ACH 直接借记)付款成功时发送。 | 向客户发送订单确认,并履行他们的订单。 |
checkout.session.async_payment_failed | 当使用延迟型支付方式(如 ACH 直接借记)付款失败时发送。 | 通知客户支付失败并引导其返回会话重新尝试支付。 |