Connect と Adaptive Pricing を併用する

Adaptive Pricing は Payment Links で常に有効です。ダッシュボードの接続設定で、Checkoutの連結アカウントの Adaptive Pricing を管理してください。 サンドボックスと本番環境で Adaptive Pricing を有効にできます。Adaptive Pricing を無効にしても、すでに変換された Checkout Session には影響しません。

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

• Bancontact
• BLIK
• EPS
• iDEAL
• Link
• P24
• Pix
• South Korean cards
• Naver Pay
• Kakao Pay
• PAYCO
• Samsung Pay

Checkout Session オブジェクトと基になる PaymentIntent オブジェクトは、顧客が支払った統合通貨と金額を反映します。金額は、価格に指定した通貨です。

顧客が現地通貨で支払う場合、checkout.session.completed イベントと payment_intent.succeeded イベントには、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 では、実装通貨を、その支払いのマーチャントオブレコードの売上処理通貨にする必要があります。

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

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

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