Adaptive Pricing

Adaptive Pricing は Payment Links で常に有効になっています。ダッシュボードの支払い設定で、Checkout の 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.

If a customer pays in their local currency, the checkout.session.completed event contains a presentment_details hash that includes the presentment_amount, presentment_currency. The amount and currency reflect what your customer paid in the local currency.

{
  "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"
      }
    }
  }
}

To test local currency presentment for Checkout and Payment Links, pass in a location-formatted customer email that includes a suffix in a +location_XX format in the local part of the email. XX must be a valid two-letter ISO country code.

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

When you visit the URL for a Checkout Session or Payment Link created with a location-formatted email, you see the same currency as a customer does in the specified country.

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 テストカードは通常どおり動作します。

Checkout で顧客の現地通貨を表示できるようになると、Checkout Session (Checkout セッション) オブジェクトが変わります。currency、payment_method_types、amount_total などのフィールドに現地の通貨と価格が反映されます。

Payment Links をテストする

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

現在、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 にして使用します。
• 作成時に currency 値を設定している場合。
• カスタムの金額を使用します。

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