コンビニ決済

コンビニ決済に対応するには、Checkout セッションで次の条件をすべて満たしている必要があります。

• ラインアイテムの価格はすべて、同じ通貨 (JPY) である必要があります。
• 使用できるのは単一の項目だけです (継続的なサブスクリプションプランには対応していません)。

このガイドでは、Konbini を有効にする方法を紹介し、カード決済を受け付ける場合と、Konbini を使用する場合の違いを説明します。

支払い方法としてコンビニ決済を有効にする

新しい Checkout セッションを作成する際は、以下を行う必要があります。

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"

その他の支払い方法オプション

支払い方法オプションは、支払い方法オプションの konbini キーで指定できます。

有効期限

保留中のコンビニ決済は、指定した日付の真夜中 (23:59:59 JST) に期限切れになります。たとえば、expires_after_days に 2 が設定され、月曜日に PaymentIntent が確定された場合、保留中のコンビニ決済は水曜日の日本時間 (UTC+9) 23:59:59 に期限切れになります。

電話番号

コンビニの決済フォームでは、顧客はオプションで電話番号を入力して確認番号として使用できます。これにより、店内の UI で支払いコードと確認番号の入力が求められるコンビニエンスストアでの支払いプロセスが簡素化されます。両方とも、顧客が決済フォームを提示した後に表示される支払い手順に反映されます。顧客が電話番号を提供しない場合、Stripe はランダムな確認番号を生成します。

電話番号がゼロのみで構成される場合、Stripe はその番号をブロックします。

Stripe がオンラインで提供する取引の詳細ページにリダイレクトする

Checkout フォームの送信に成功すると、顧客は hosted_voucher_url にリダイレクトされます。顧客はオンラインで提供されるページに記載されている支払い手順書を参照して、支払いを完了する詳しい方法を確認できます。このページはデスクトップとモバイルで見ることができ、印刷も可能です。

Stripe は、コンビニ決済用の取引詳細が正常に作成されると、payment_intent.requires_action イベントを送信します。店舗支払いの詳細を記載したリンクを顧客にメールで送信する必要がある場合は、payment_intent.next_action.konbini_display_details に hosted_voucher_url が含まれています。Webhook で PaymentIntent を監視する方法をご確認ください。

Stripe では、ブランディング設定 ページで顧客に表示される UI をカスタマイズすることができます。取引の詳細には、以下のブランド設定を適用できます。

• アイコン: ブランド画像と公開ビジネス名
• アクセント:「番号をコピー」ボタンのカラーとして使用されます
• ブランドカラー: 背景色として使用されます

注文のフルフィルメントを実行する

Konbini は通知遅延型の支払い方法であるため、Webhook などの方法を使用して支払いステータスを監視し、注文のフルフィルメントを履行する必要があります。詳細については、Webhook の設定と注文のフルフィルメントの履行をご覧ください。

支払いのステータスに変化があると、以下のイベントが送信されます。

Checkout の組み込みをテストする際は、支払い方法としてコンビニ決済を選択して、支払うボタンをクリックします。

決済フォームに次の値を指定して、さまざまなシナリオをテストします。特殊な確認番号とメールパターンのいずれかを使用してテストできます。両方を指定した場合、特殊な確認番号の動作が適用されます。

確認番号のエラーをテストするには、以下の値を使用できます。

• 01234567890 は、確認番号の拒否をシミュレートします。
• 00000000000 は検証エラーを引き起こします。