自定义结账行为

自定义“提交”按钮

为了更好地使 Checkout 符合您的业务模式，请为一次性购买设置 Checkout 提交按钮上显示的文本。

在会话上定义一个 submit_type。该例中（捐款 5 美元），您自定义的 Checkout 提交按钮上会读作捐款 5.00 美元。参阅 API 参考，获取 submit_type 选项的完整列表。

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d submit_type=donate \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d ui_mode=embedded \
  --data-urlencode return_url="https://example.com/return"

本地化与支持的语言

默认情况下，Checkout 会检测客户浏览器的位置，并据此以他们的语言显示翻译的页面，如果 Stripe 支持的话。创建 Checkout Session 时，可以通过传递 locale parameter 来覆盖 Checkout 的浏览器区域设置。

Checkout 还会用位置来确定数字和货币的格式。例如，销售一种产品，位置设置为 auto，价格的币种设置为 EUR，那么配置为使用英语 English (en) 的浏览器会显示 €25.00，而配置为德语 German (de) 的浏览器，则显示 25,00 €。

用 Link 自动填充支付详情

您可以在预构建的结账页面中自动使用 Link（Stripe 点击给产品结账）。如需进一步了解，请查看在 Checkout 中使用 Link

筛选银行卡品牌

您可以在 Checkout Session 中指定阻止客户的哪个银行卡品牌。

要阻止特定的银行卡品牌，您可以在创建 Checkout Session 时包含 brands_blocked 参数。传递具有以下任意卡品牌值的数组：

• visa
• mastercard
• american_express
• discover_global_network

discover_global_network 值包含 Discover Global Network 中的所有卡，包括 Discover、Diners、JCB、中国银联和 Elo。

以下代码示例通过将 brands_blocked 参数设置为 ['american_express'] 来初始化 Checkout Session，这会阻止客户使用 American Express 卡。

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  --data-urlencode return_url="https://example.com/return" \
  -d "payment_method_options[card][restrictions][brands_blocked][0]"=american_express

如果客户在 Checkout 中输入的卡号不受支持，则会显示一条错误消息，告知不接受他们的银行卡品牌。

此时会显示一个错误信息，通知客户您不接受 Visa（或您阻止的任何银行卡品牌）。

此外，如果保存的银行卡被阻止，Link 还会禁用回头客保存的银行卡。

如果 Link 用户保存的银行卡被阻止，则会被禁用。

Checkout 还会筛选 Apple 和 Google Pay 钱包中的银行卡、客户保存的支付方式以及联名卡组织。