Konbini 支付

Checkout Session 必须满足以下所有条件才能支持 Konbini 付款：

• 所有行项目的价格都必须使用同一币种 (JPY)。
• 您只能使用一次性的行项目（不支持经常性订阅方案）。

使用本指南了解如何启用 Konbini — 它展示了用银行卡收款和用 Konbini 收款之间的区别。

启用 Konbini 这一支付方式

创建新的 Checkout Session 时，您需要：

1. 将 konbini 添加到 payment_method_types 列表
2. 确保您的所有 line_items 都使用 jpy 货币。

curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "mode"="payment" \
  -d "payment_method_types[]"="card" \
  -d "payment_method_types[]"="konbini" \
  -d "payment_method_options[konbini][expires_after_days]"=3 \
  -d "line_items[0][price_data][currency]"="jpy" \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][price_data][product_data][name]"="Tシャツ" \
  -d "line_items[0][quantity]"=1 \
  -d "success_url"="https://example.com/success" \
  -d "cancel_url"="https://example.com/cancel"

其他支付方式选项

支付方式选项可以在 payment method options（konbini 参数下）中指定。

有效期

待处理的 Konbini 付款在特定日期的午夜 (23:59:59 JST) 准时过期。例如，如果 expires_after_days 设置为 2，然后未在周一确认 PaymentIntent，则待处理的 Konbini 付款将在日本时间 (UTC+9) 周三的 23:59:59 过期。

电话号码

在 Konbini 结账表单上，您的客户可以选择提供一个电话号码作为他们的确认码。这简化了他们在便利店的支付过程，店内的 UI 要求客户提供付款码和确认码。这两者都反映在客户提交完结账表单后 Stripe 显示的付款说明中。如果您的客户没有提供电话号码，则 Stripe 会生成一个随机的确认码。

Stripe 主动阻止仅包含零的电话号码。

重定向到 Stripe 托管的付款凭单页面

成功提交 Checkout 表单后，客户被重定向到 hosted_voucher_url。客户可以参考托管页面的付款说明，了解如何完成付款的详细信息。该页面可以在桌面电脑和手机上查看，还可以打印。

成功创建 Konbini 付款凭单时，Stripe 会发送一个 payment_intent.requires_action 事件。如果您需要通过邮件给客户发送付款凭单的付款说明链接，可以在 payment_intent.next_action.konbini_display_details 中找到 hosted_voucher_url。了解如何用 Webhook 监测 PaymentIntent。

Stripe 允许在品牌设置页面自定义面向客户的 UI。下列品牌设置项可应用付款凭单：

• 图标——您的品牌图片及公开的商家名称
• 强调色——用作复印数字按钮的颜色
• 品牌颜色——用作背景颜色

履行订单

由于 Konbini 是一种延迟通知型支付方式，因此您需要用一种方式（例如 webhooks）来监测付款状态并处理订单履行情况。了解有关设置 Webhook 和履行订单的更多信息。

付款状态变化时会发送以下事件：

测试您的 Checkout 集成时，选择 Konbini 这一支付方式，然后点击支付按钮。

在 Checkout 内提供以下值，以测试不同的场景。您可以用专用确认码或邮件样式来测试。如果两者都用，则专用确认码的行为适用。

要测试确认码的错误，可以使用以下值：

• 01234567890 模拟确认码被拒绝的情况。
• 00000000000 会导致验证错误。