自定义文本和策略

当客户通过 Stripe Checkout 使用托管支付页面或嵌入式支付表单付款时，您可以显示附加文本，例如运输和处理时间。

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 \
  -d "shipping_address_collection[allowed_countries][0]"=US \
  --data-urlencode "custom_text[shipping_address][message]"="Please note that we can't guarantee 2-day delivery for PO boxes at this time." \
  --data-urlencode "custom_text[submit][message]"="We'll email you instructions on how to get started." \
  --data-urlencode "custom_text[after_submit][message]"="Learn more about **your purchase** on our [product page](https://www.stripe.com/)." \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

自定义收货地址收集字段旁的文字

自定义支付按钮上方的文字

自定义支付按钮后的文字

您的自定义文本限 1200 个字符。但是，Stripe Checkout 针对转化进行了优化，添加额外信息可能会影响您的转化率。您可以加粗文本或用 Markdown 语法插入链接。

自定义“提交”按钮

为了使 Checkout 功能更符合您的业务模式，请为一次性购买操作中的 Checkout 提交按钮配置所显示的文本。

在会话内定义 submit_type。在本例中（捐款 5 美元），您自定义的 Checkout 提交按钮显示 捐款 5.00 美元。有关 submit_type 选项的完整列表，请参阅 API 参考文件。

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 \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

本地化与支持的语言

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

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

自定义策略和联系信息

您可以在 Checkout 上向客户显示您的退货、退款、法律政策及客服联系信息。前往 Checkout 设置，配置想要显示的信息：

• 您的退货和退款政策详情
• 您的客服电话、邮箱和网站
• 您的服务条款和隐私政策链接

展示该信息有利于增强买家信心，最小化购物车放弃率。

配置支持和法律政策

在 Checkout 设置中，启用联系信息，向您的会话中添加客户支持的联系信息。与之类似，通过选择法律政策，向您的会话添加服务条款和隐私政策的链接。如果您要求客户在完成结账时隐式地同意您的法律政策，则选择复选框显示法律条款协议。

您必须在您的公开详情设置中添加您的客户支持的联系信息和法律政策链接。

下面的预览图显示了 Checktout 如何通过对话框的形式显示客服联系信息、店铺法律政策的链接以及相关付款条款的信息。

Checkout 上的联系信息预览。

Checkout 上的法律政策预览。

配置退货和退款政策

启用退货和退款政策，显示您的退货、退款或退换政策。销售实物商品的公司一般使用退货政策，而销售数字商品或定制实物商品的公司通常使用退款政策。由于这两者并不排斥，因此如果您的公司同时销售这两类商品，则可以两个都选。您可以修改您的退货和退款详情，包括：

• 您是否接受退货、退款或退换
• 退货、退款或退换是免费的还是要收取一定费用
• 您在购买后的多少天内接受退货、退款或退换
• 客户如何退回寄给他们的商品
• 您是否接受店内退货
• 退货和退款政策全文链接
• 自定义消息

如果您接受免费退货、退款或退换，则 Checkout 会为客户突出该政策。

下面的预览图为 Checkout 显示退款政策的方式。该例中，60 天以内购买的商品可通过邮寄或到店获得全额退款（或退换）。您可以显示类似的退款政策。

Checkout 上的退货政策预览。

Checkout 上政策突出显示预览

收集服务协议条款

商家通常会要求客户同意他们的服务条款，然后才能付款。这可能取决于产品或订阅的类型。Checkout 可帮助您收集必要的协议，要求客户在付款前接受您的条款。

收集服务协议条款

您可以在创建 Session 时通过 Stripe Checkout 收集服务条款协议：

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}" \
  -d "line_items[0][quantity]"=2 \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel" \
  -d "consent_collection[terms_of_service]"=required \
  --data-urlencode "custom_text[terms_of_service_acceptance][message]"="I agree to the [Terms of Service](https://example.com/terms)"

当 consent_collection.terms_of_service='required' 时，Checkout 会动态显示一个复选框，用于收集客户的服务条款协议。如果 consent_collection.terms_of_service='none'，则 Checkout 不会显示复选框，也不会要求客户接受服务条款。在要求同意您的条款前，在您的公开详情中设置您的服务条款 URL。设置隐私政策 URL 是一项可选操作——如果在您的公开信息中设置了隐私政策的 URL，那么结账页面还会链接到您的隐私政策。

客户完成结账后，您可以通过查看 checkout.session.completed webhook 中的 Session 对象或使用 API 检索 Session 来验证客户是否接受了您的服务条款。当接受条款后，Session 的 consent.terms_of_service 字段被设置为 accepted。

您可以用 custom_text.terms_of_service_acceptance 自定义复选框旁显示的文本。您需要设置 consent_collection.terms_of_service='required'。要使用您自己的条款，请插入一个 Markdown 链接。例如：I agree to the [Terms of Service](https://example.com/terms)

收集促销电子邮件的许可

您可以发送促销邮件来通知客户新产品并分享优惠券和折扣。在执行此操作前，必须先收集他们的许可，然后才能接收促销邮件。

自定义支付方式重复使用协议和订阅条款

当会话处于 setup 或 subscription 模式，或者处于设置了 setup_future_usage 的 payment 模式时，Checkout 会显示一条关于复用客户的支付方式的消息。该消息可以包含所选支付方式的特定信息。您可以隐藏或自定义默认文本，但不能隐藏或自定义支付方式特定的文本。

对于订阅，自定义文本可以包含如下信息：

• 您的订阅条款的链接
• 您的客户门户的链接
• 取消机制和政策

订阅模式下的默认支付方式复用协议

要隐藏支付方式复用协议文本，请设置 consent_collection.payment_method_reuse_agreement.position='hidden'。Checkout 不会显示其管理重复使用支付方式的默认语言。要设置您自己的文本来代替 Stripe 的默认语言，请设置 custom_text.after_submit.message。您还可以使用 custom_text.submit 或 custom_text.terms_of_service_acceptance 显示您自己的该语言版本。

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=subscription \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel" \
  -d "consent_collection[payment_method_reuse_agreement][position]"=hidden \
  --data-urlencode "custom_text[after_submit][message]"="You can cancel your subscription at any time by [logging into your account](https://www.example.com/)"