调至内容部分
创建账户或登录
Stripe 文档徽标
/
创建账户登录
概览收款升级您的集成
线上付款
概览查找您的用例使用 Managed Payments经常性付款
线下支付
支付方式
支付操作
余额和结算时间收据退款与取消
高级集成
超越支付功能

自定义重定向行为

显示包含客户订单信息的确认页面。

如果您的 Checkout 集成使用的是 Stripe 托管页面，Stripe 会将您的客户重定向到您在网站上创建和托管的成功页面。您可以用 Checkout Session中的详情在客户付款后向其显示订单确认页面（例如，他们的姓名或付款金额）。

将客户重定向到成功页面

使用来自 Checkout Session 的详情：

  1. 修改 success_url，将 Checkout Session ID 传递到客户端。
  2. 用 ID 在您的成功页面上查找 Checkout Session。
  3. 用 Checkout Session 自定义成功页面的显示内容。

履行需要 Webhook

由于客户并不能保证一定会访问您的 Checkout 登录页面，因此您不能只依赖通过此页面触发履行。例如，客户支付成功后，可能会在登录页面加载完成前就失去了与互联网的连接。

设置 Webhook 事件处理程序，由此 Stripe 可以完全绕过客户端，直接向您的服务器发送支付事件。Webhook 提供了最可靠的收款确认方式。如果 Webhook 事件发送失败，Stripe 会重试多次。

修改成功 URL Server-side

创建 Checkout Session 时，向 success_url 添加 {CHECKOUT_SESSION_ID} 模板变量。注意，这是一个文字串，必须原封不动地添加。不要用 Checkout Session ID 代替它——客户付完款并被重定向到成功页面会自然显示。

Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
session = Stripe::Checkout::Session.create(
  success_url: "http://yoursite.com/order/success",
  success_url: "http://yoursite.com/order/success?session_id={CHECKOUT_SESSION_ID}",
  # other options...,
)

创建成功页面 Server-side

用 ID 查找 Checkout Session，并创建一个成功页面，用以显示订单信息。该例会打印出客户的姓名：

Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# This example sets up an endpoint using the Sinatra framework.


# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'


require 'sinatra'

get '/order/success' do
  session = Stripe::Checkout::Session.retrieve(params[:session_id])
  customer = Stripe::Customer.retrieve(session.customer)

  "<html><body><h1>Thanks for your order, #{customer.name}!</h1></body></html>"
end

测试集成

要确认您的重定向操作能够正常进行，请执行以下操作：

  1. 点击结账按钮。
  2. 填写客户名称和其他付款详情。
  3. 点击支付。

成功之后，您会被重定向到带有自定义消息的成功页面。例如，如果您在代码示例中使用了该消息，则成功页会显示以下消息：感谢您的订单，Jenny Rosen！