Adaptive Pricing

Adaptive Pricing は Payment Links で常に有効になっています。ダッシュボードの支払い設定で、Checkout の Adaptive Pricing を管理します。Adaptive Pricing は、サンドボックスと本番環境で有効にできます。Adaptive Pricing を無効にしても、すでに換算が実行されている Checkout セッションには影響しません。

Adaptive Pricing を導入すると、顧客が最も関連性の高い決済手段を使って現地通貨で支払うことができるため、地域固有の決済手段の利用が増える可能性があります。たとえば、オランダの EC 取引全体の 70% で iDEAL が利用されていますが、この決済手段ではユーロしか使用できません。動的な決済手段を使用する場合は、決済手段の設定で受け付ける決済手段を設定できます。Adaptive Pricing を使用すると、現地通貨での提示が必須である次の決済手段を利用できるようになります。

• Bancontact
• EPS
• iDEAL
• Link
• P24

Adaptive Pricing は、イベントの送信先やレポートなど、システムの一部に影響を与える可能性があります。構築済みの Stripe システムを確認し、イベントの送信先が現地通貨で PaymentIntent オブジェクトを処理できることを確かめてください。

• Checkout Session オブジェクトの通貨と合計金額を使用して、システムで使用されている通貨で顧客が支払った金額を判断します。これは、価格に指定した通貨です。
• Checkout Session オブジェクトの presentment_details ハッシュを使用して、顧客が現地通貨で支払った金額を特定します。

Checkout Session オブジェクトとその基になる PaymentIntent オブジェクトには、システムで使用されている通貨と金額が反映されます。

顧客が現地通貨で支払った場合、checkout.session.completed イベントには presentment_amount と presentment_currency を含む presentment_details ハッシュが含まれます。金額と通貨には、顧客の現地通貨での支払い情報が反映されます。

{
  "id": 
'{{EVENT_ID}}',
  "object": "event",
  "type": "checkout.session.completed",
  "data": {
    "object": {
      "id": 
'{{SESSION_ID}}',
      "object": "checkout.session",
      "currency": "usd",
      "amount_total": 1000,
      "amount_subtotal": 1000,
      "presentment_details": {
        "presentment_amount": 1370,
        "presentment_currency": "cad"
      }
    }
  }
}

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

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

地域に応じた形式のメールアドレスで作成された、Checkout セッションまたは Payment Links の URL にアクセスすると、指定した国で顧客に表示されるのと同じ通貨が表示されます。

Checkout をテストする

特定の国から 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 success_url="https://example.com/success" \
  --data-urlencode customer_email="test+location_FR@example.com"

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

Payment Links をテストする

Payment Links の場合、prefilled_email URL パラメーターとして地域に応じた形式のメールアドレスを渡して、さまざまな国の顧客に対する通貨表示をテストします。

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

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

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

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

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

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