決済の動作をカスタマイズする

送信ボタンをカスタマイズする

Checkout がお客様のビジネスモデルに適合するように、1 回限りの購入に対する Checkout の送信ボタンに表示されるコピーを設定できます。

セッションで submit_type を定義します。この例 (5 ドルの寄付) では、カスタマイズされた Checkout の送信ボタンに 5 ドルを寄付と表示されます。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"

Localization and supported languages

By default, Checkout detects the locale of the customer’s browser and displays a translated version of the page in their language, if Stripe supports it. You can override the browser locale for Checkout by passing the locale parameter when you create a Checkout Session.

Checkout also uses the locale to format numbers and currencies. For example, when selling a product whose price is set in EUR with the locale set to auto, a browser configured to use English (en) would display €25.00 while one configured for German (de) would display 25,00 €.

Link を使用して支払いの詳細を自動入力する

構築済みの Checkout ページで、Link (Stripe のワンクリック決済) を自動的に使用できます。 詳細は Checkout で Link を使用するをご覧ください。

Filter card brands

Checkout セッションで、顧客からブロックするカードブランドを指定できます。

To block specific card brands, you can include the brands_blocked parameter when creating a Checkout Session. Pass an array with any of the following card brand values:

• visa
• mastercard
• american_express
• discover_global_network

The discover_global_network value encompasses all of the cards that are part of the Discover Global Network, including Discover, Diners, JCB, UnionPay, and Elo.

The following code example initializes the Checkout Session with the brands_blocked parameter set to ['american_express'], which prevents customers from using American Express cards.

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 also filters cards in Apple and Google Pay wallets, customer’s saved payment methods, and networks from co-badged cards.