Adaptive Pricing

ダッシュボードの決済設定で、決済用の Adaptive Pricing を管理します。サンドボックスと本番環境で Adaptive Pricing を有効にできます。Adaptive Pricing を無効にしても、すでに変換されている Checkout Sessions には影響しません。

決済ページ全体で、選択した通貨に従って、項目、配送料、割引、税金、合計など、価格を一貫して表示することが重要です。

Adaptive Pricing で埋め込みコンポーネントを使用する場合、Adaptive Pricing が有効であれば、埋め込みコンポーネントの Session オブジェクトに換算後の金額を含めることができます。サイトを訪れる買い手の国の通貨と換算額がセッションに表示されるよう、システムを設計する必要があります。このワークフローの内容は、session.total.total.amount などの事前設定されたフィールドに依存します。Stripe API で返される Checkout Session オブジェクトの通貨は、presentment_details の顧客コンテキストが使用されている Stripe システムの通貨のまま維持されます。また、埋め込みコンポーネントの Session オブジェクトの通貨と直接一致するとは限りません。

const { actions } = await checkout.loadActions();
const { total } = actions.getSession();

// Display the formatted amounts in your UI
document.getElementById('order-total').textContent = total.total.amount;

Currency Selector Element は、Adaptive Pricing の機能をサポートする埋め込み UI コンポーネントです。これは注文合計額の近くに表示されます。

<div id="currency-selector"></div>

const currencySelectorElement = checkout.createCurrencySelectorElement();
currencySelectorElement.mount('#currency-selector');

デザインのベストプラクティス

決済ページ向けに、設定可能な Currency Selector Element を用意しています。セレクターを配置する場所を選択する際には、次のベストプラクティスに従ってください。

• 選択した通貨によって利用可能な決済手段に影響が及ぶ可能性があるため、Currency Selector は支払い情報を入力する場所の近く、理想としては Payment Element の真上に配置してください。
• 最初の時点で Payment Element が表示されない場合 (複数ステップのフローがあるか、ページの下部にあるため)、通貨セレクターを合計金額の表示の近くに配置します。
• Express Checkout Element を使用している場合は、Express Checkout Element の上に Currency Selector Element を配置し、顧客が請求される通貨を把握できるようにすることをお勧めします。
• これらのヒントを、すべての画面サイズのページレイアウトに適用してください。

Once you have localized and formatted your prices and rendered the currency selector, mark your integration as ready for Adaptive Pricing by setting the adaptivePricing.allowed parameter when you initialize checkout.

const checkout = stripe.initCheckout({
  clientSecret,
  // Mark your integration as ready for Adaptive Pricing
  adaptivePricing: {
    allowed: true
  }
});
// Use `checkout` to build your checkout page

統合の準備完了としてマークされたら、ダッシュボードの決済設定で、またはadaptive_pricing.enabledパラメーターを使用して、Checkout Sessionごとに Adaptive Pricing を管理できます。

Adaptive Pricing では、顧客が現地通貨で支払うオプションと、顧客に最も適した支払い方法を選択できるようにすることで、現地の支払い方法の使用状況を増やすことができます。たとえば、オランダの E コマース取引の 70% で iDEAL が使用されていますが、iDEAL は EUR でのみ機能します。動的な支払い方法を使用する場合は、支払い方法設定 で受け付ける支払い方法を設定できます。Adaptive Pricing では、現地通貨での表示が必要な以下の支払い方法を利用できます。

• Amazon Pay
• Bancontact
• BLIK
• EPS
• iDEAL
• Link
• P24
• Pix
• 韓国のカード
• Naver Pay
• Kakao Pay
• PAYCO
• Revolut Pay
• Samsung Pay
• WeChat Pay

現地通貨での表示をテストするには、メールアドレスのローカル部分に +location_XX 形式のサフィックスを含めて、地域に応じた形式の顧客メールアドレスを渡します。XX は有効な 2 文字の ISO 国コードである必要があります。

たとえば、フランスで顧客への通貨の表示をテストする場合は、test+location_FR@example.com のようにしてメールアドレスを渡します。

現地のメールアドレス形式に応じて作成される CheckoutSession を使用して、Currency Selector Element と Payment Element が実装された決済ページを表示すると、指定した国の顧客に表示される通貨が表示されます。

特定の国から Checkout のシミュレーションを行うため、Checkout セッションの作成時に customer_email として地域に応じた形式でメールアドレスを渡します。

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 ui_mode=custom \
  -d "adaptive_pricing[enabled]"=true \
  -d return_url={{RETURN_URL}} \
  --data-urlencode customer_email="test+location_FR@example.com"

Customer (顧客) を作成して、+location_XX サフィックスが含まれるメールアドレスを指定することもできます。Stripe テストカードは通常どおり動作します。

Adaptive Pricing は、Payment Intents API で Elements を使用しているビジネスではご利用いただけません。

Adaptive Pricing はインドのビジネスではサポートされていません。

また、Adaptive Pricing では、価格の通貨が売上処理通貨のいずれかである必要があります。価格は購入時に自動的に換算されます。これは、作成して価格 ID で参照する価格と、Checkout セッションの作成時に price_data を使用して作成するインライン価格に適用されます。

プラットフォームを介して決済を処理する場合、プラットフォームの実装通貨を、その支払いのマーチャントオブレコードの売上処理通貨にする必要があります。

Adaptive Pricing は、次のような Checkout セッションには適用されません。

• 明示的に定義された 手動通貨価格 を含む。
• subscription モードの場合。
• capture_method は manual にして使用します。
• カスタムの金額を使用します。

Adaptive Pricing が対応していない Checkout セッションでは、料金を設定した元の通貨で料金が提示されます。