Adaptive Pricing

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

Adaptive Pricing は、決済フロー、Payment Links、料金表、現地の決済手段に対応しています。

You can configure which payment methods you accept in your payment methods settings. Adaptive Pricing can increase the usage of local payment methods by ensuring customers have the option to pay in their 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. Adaptive Pricing enables the following payment methods:

• Alipay
• Bancontact
• BLIK
• Canadian pre-authorized debit
• EPS
• iDEAL
• Link
• PayPal
• P24
• SEPA Debit
• Sofort
• Swish
• WeChat Pay

Adaptive Pricing を有効にすると、イベントの送信先やレポートなど、実装の一部に影響を与える可能性があります。実装を見直して、イベントの送信先が現地通貨の PaymentIntent オブジェクトを処理できることを確認してください。

• Checkout Session オブジェクトの currency_conversion ハッシュを使用して、顧客がデフォルトの通貨で支払うはずだった金額を判断します。
• BalanceTransactions API を使用して、手数料を差し引いた後に受け取る金額を判断します。

ユーザーが選択した通貨に応じて、Checkout セッションとその基になる PaymentIntent オブジェクトの両方が自動的に更新され、選択した通貨と金額が反映されます。ユーザーが現地通貨で支払うと、Checkout Session オブジェクトの通貨と合計金額は現地通貨になり、このオブジェクトには、ユーザーがデフォルトの通貨で支払うはずだった金額が反映された currency_conversion ハッシュが含まれます。詳しくは手数料を差し引いた後にアカウントに入金される金額をご覧ください。

checkout.session.completed イベントには、source_currency に amount_total と amount_subtotal がある currency_conversion ハッシュが含まれています。金額には、顧客が送金元の通貨で支払うはずだった金額が反映されます。

{
  "id": 
'{{EVENT_ID}}',
  "object": "event",
  "type": "checkout.session.completed",
  "data": {
    "object": {
      "id": 
'{{SESSION_ID}}',
      "object": "checkout.session",
      "currency": "cad",
      "amount_total": 2055,
      "amount_subtotal": 2055,
      "currency_conversion": {
        "amount_subtotal": 1500,
        "amount_total": 1500,
        "source_currency": "usd",
        "fx_rate": "1.37"
      }
    }
  }
}

To test local currency presentment for Checkout, Payment Links, and the pricing table, 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, Payment Link, or pricing table 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 パラメーターとして地域に応じた形式のメールアドレスを渡して、さまざまな国の顧客に対する通貨表示をテストします。

料金表をテストする

料金表の場合は、customer-email 属性として地域に応じた形式のメールアドレスを渡して、さまざまな国の顧客への通貨の表示をテストします。