Connect と Adaptive Pricing を併用する

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

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

• Bancontact
• EPS
• iDEAL
• Link
• P24

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 では、実装通貨を、その支払いのマーチャントオブレコードの売上処理通貨にする必要があります。

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

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

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