Adaptive Pricing

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

Adaptive Pricing can increase the usage of local payment methods by ensuring customers have the option to pay in their local currency and with payment methods most relevant to them. As an example, 70% of all e-commerce transactions in the Netherlands use iDEAL, but it only works with EUR. You can configure which payment methods you accept in your payment methods settings if you use dynamic payment methods. Adaptive Pricing unlocks access to the following payment methods that require presenting in local currency:

• Bancontact
• EPS
• iDEAL
• Link
• P24

Adaptive Pricing can affect some parts of your integration, such as event destinations and reporting. Review your integration to make sure any event destinations can handle PaymentIntent objects with local currencies.

• Use the Checkout Session object’s currency and total amount to determine what your customer paid in your integration currency, which is the currency you specified for your prices.
• Use the presentment_details hash on the Checkout Session object to determine what your customer paid in their local currency.

The Checkout Session and the underlying PaymentIntent objects reflect your integration currency and amount.

顧客が現地通貨で支払った場合、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"
      }
    }
  }
}

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

たとえば、フランスの顧客に対する通貨の提示をテストするには、test+location_FR@example.com などのメールアドレスを渡します。地域に応じた形式のメールアドレスで作成された Checkout セッションには、指定した国と同じ通貨が表示されます。

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=embedded \
  -d return_url="https://example.com/return" \
  --data-urlencode customer_email="test+location_FR@example.com"

Customer を作成し、+location_XX サフィックスを含むメールアドレスを指定することもできます。Stripe テストカードは通常どおり機能します。

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

Additionally, Adaptive Pricing requires the currency for your prices to be one of your settlement currencies. Prices automatically convert during checkout. This applies to prices you create and reference with a price ID and prices you create inline with price_data when you create a Checkout Session.

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

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

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