FX Quotes API公開プレビュー

顧客の現地通貨で価格を表示すると、購入完了率と決済のオーソリ率が向上します。通貨を換算するには、次の点を考慮する必要があります。

• 決済前にサイトに表示する適切な外貨額。
• 取引に適用される現在の為替レートと外貨為替 (FX) 手数料。
• ご利用通貨で Stripe 残高に入金される金額。
• 為替レートの変更回数と現地価格への更新タイミング。

FX Quotes API は、以下の通貨換算機能を提供します。

• 現在の為替レート: 特定の通貨ペアを対象とする Stripe の現在の為替レート。
• 拡張為替レートの見積もり: 5 分、1 時間、24 時間のレート見積もりを作成して、為替変動による不確実性を減らせます。
• 外国為替手数料情報: 取引に適用される Stripe の外国為替手数料の詳細。決済コストを差し引く前に売上処理金額を概算できます。

利用規約

FX Quotes API を利用することにより、お客様は以下の利用規約に同意したものとみなされます。

• FX Quotes API は現在、「プレビュー版のサービス」として提供されています。これは、Stripe がサービスを「現状有姿」で提供し、このサービスに関するすべての明示的または黙示的な保証を否認するという意味です。お客様がプレビュー版サービスを利用する場合は自己責任となり、Stripe はプレビュー版サービスの正確性に関連して発生した損失、損害、費用について責任を負いません。
• FX Quotes API は、将来の一定期間有効な特定の通貨ペアの見積もりを提供する場合があります。これを、拡張レート見積もりと呼びます。この見積もりは、外国為替取引を行うためのオファーではなく、Stripe がいつでも取り消すことができるものです。
• FX Quotes API と拡張レート見積もりの機能は、貴社が Stripe で販売する商品やサービスの商取引の一部として使用する必要があります。
• 拡張レート見積もりは、外国為替 (FX) レートの一般的な不確実性に対処するのに役立ちます。特定の状況で選択的に使用しその他の状況では使用しない、という拡張レート見積もりの使い方はできません。たとえば、市場の外国為替レートが拡張レート見積もりよりも不利な場合にのみ、拡張レート見積もりを使用することはできません。
• Stripe は、予告なしにいつでも FX Quotes API のサポート対象通貨を追加または削除することがあります。

FX Quotes API を設定して使用する

SDK を使用している場合は、SDK のバージョン管理を参照して、プレビュー版の機能にアクセスするための設定を追加してください。SDK を使用せず、API エンドポイントを直接呼び出す場合は、API コールで API バージョンと共にベータヘッダーを指定します。

require 'stripe'
Stripe.api_key = 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
Stripe.api_version = '2025-05-28.basil'
Stripe.add_beta_version("fx_quote_preview", "v1")

最適な現地価格を設定する

FX Quotes API のレートを使用すると、自国の顧客に請求する価格に基づいて、他の国向けに適応させた価格を設定できます。地域に適応させた価格を確定する際は、現地市場の価格の微妙な違いと、最も近い整数に価格を四捨五入するかどうかを考慮してください。

顧客がどの通貨で支払っても同じ金額を受け取れるよう、Stripe の FX 手数料を顧客に渡すことができます。たとえば、アメリカを拠点とする加盟店が 100 USD の商品をフランスで販売するとします。同等の価格を EUR で計算するには、exchange_rate パラメーターを使用して FX 手数料を顧客に転嫁します。この手数料を転嫁したくない場合は、base_rate パラメータを使用します。以下のレスポンスの例は、現地通貨 EUR で表示された価格を決済通貨 USD に変換するために作成された見積もりを示しています。

{
  "id": "fxq_1R6BWhL05bA97JHQELB5EROs",
  "object": "fx_quote",
  "created": 1742824731,
  "lock_duration": "five_minutes",
  "lock_expires_at": 1742825031,
  "lock_status": "active",
  "to_currency": "usd",
  "rates": {
    "eur": {
      "exchange_rate": 1.06053,
      "rate_details": {
        "base_rate": 1.08295,
        "duration_premium": 0.0007,
        "fx_fee_rate": 0.02,
        "reference_rate": 1.0827,
        "reference_rate_provider": "ecb"
      }
    }
  },
  "usage": {
    "payment": {
      "destination": null,
      "on_behalf_of": null
    },
    "transfer": null,
    "type": "payment"
  }
}

上記の例を使用して、外貨為替手数料を顧客に転嫁します。商品価格 (100 USD) を為替レート (1.06053) で割って、為替手数料を含むフランスの顧客向けの価格 94.29 EUR を出します。外貨為替手数料を転嫁しない場合は、商品価格 (100 USD) を、為替手数料を除いた価格の基本レート (1.08295) で割ります (92.34 EUR)。越境取引には、地域と決済手段によっては、国際決済手段の手数料もかかります。詳細は、Stripe の料金体系ページをご確認ください。

見積もり期間と料金の変更

FX Quotes API によって提供される為替レート情報を使用して価格をローカライズする場合、特定のレートが有効な期間について確実性が必要な場合があります。FX Quotes API は、lock_duration に five_minutes、hour、day の 3 つの期間を提供します。この期間は、lock_expires_at で示されているように、有効期限が切れる前に指定されたレートを使用する限り、取引が見積もり為替レートで変換されることを示します。

FX Quotes API は、現在の本番 Stripe 為替レートの為替レート情報も提供します。このためには、lock_duration を none に設定します。

When lock_duration is set to 5 minutes, 1 hour, or 1 day, the duration_premium field includes the fee charged for the extended rate quote. To determine the right lock duration, consider how regularly local prices are refreshed and how long a checkout session lasts.

時折、通貨市場はボラティリティを経験し、特定の見積もりを尊重する当社の能力に影響を与える可能性があります。決済用に作成された拡張レート見積もりのレートしきい値は 3.5% で、送金用に作成された拡張レート見積もりのレートしきい値は 1% です。為替レートがこれらのしきい値を超える場合、拡張レート見積もりは無効になり、lock_status は expired に変更されます。

When you use an expired quote for a PaymentIntent or Transfer, you receive an error.code of either payment_intent_fx_quote_invalid or transfers_fx_quote_invalid. You can use these error codes to handle expired quotes.

固定為替レートを使用して価格を各地域に適応させる

たとえば、イギリスを拠点とし、アメリカの顧客向けに現地価格を設定している加盟店で、USD-GBP の為替レートの変動に関係なく 100 GBP を受け取るとします。このシナリオでは、lock_duration を hour に指定して拡張レートの見積もりを取得することをお勧めします。

curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-05-28.basil; fx_quote_preview=v1" \
  -d to_currency=gbp \
  -d "from_currencies[]"=usd \
  -d lock_duration=day

USD の最新の為替レートがたとえば 0.8 の場合、価格 (100 GBP) を為替レート (0.8) で割って、現地通貨での価格 125 USD を計算します。この為替レートは今後 1 時間は固定されるため、サイトや決済ページで、アメリカの顧客に 125 USD を表示できます。

アメリカの価格125 USDを Payment Intents API に渡し、fx_quote パラメーターを使用して決済を行うことができます。

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-05-28.basil; fx_quote_preview=v1" \
  -d amount=125 \
  -d currency=usd \
  -d fx_quote=fxq_1QBck4FTKRd55CNDdboZYz9g

補助単位の処理

すべての API リクエストは、通貨の補助単位の amount 値を想定しています。FX Quotes API で提供されたレートを使用した後、換算後の金額を Stripe の補助単位に変換します。詳細については、API 金額の補助単位および小数点以下なしの通貨を参照してください。

見積もりの有効期限を処理する

Stripe は、有効期限または大幅なレートの変動により見積もりが無効になると、fx_quote.expired Webhook を送信します。すでに有効期限が切れている FX Quote オブジェクトを PaymentIntent API または Transfer API に関連付けると、400 のステータスコードが返されます。fx_quote.expired Webhook イベントに登録し、イベントの受信後に新しい拡張レート見積もりを作成して、新しい FX Quote オブジェクトに基づいてローカライズされた価格を更新できるようにすることをお勧めします。

仲値レートのフォールバック

カード以外の決済手段の中には、24 時間のロック期間よりも支払いの処理に時間がかかるものがあります。これらの支払いでは、拡張レート見積もりは、市場中央値の大幅な変動により、期限切れになったり、使用できなくなる可能性があります。このような場合は、市場中央値を使用して支払いを処理します。

料金体系

ロック期間が none の拡張レート見積もりに対しては請求されません。lock_duration が five_minutes、hour または day に設定されている場合、Stripe は発生したリスクとコストをカバーするために手数料を請求します。この手数料は duration_premium フィールドに表示され、base_rate に追加され exchange_rate が計算されます。

正確な手数料は、lock_duration と通貨換算に使用される通貨ペアによって異なります。拡張レート見積もりの手数料を計算するには、以下の表をご覧ください。グループ 2 の通貨からグループ 1 の通貨に変換する場合 (またはその逆) は、グループ 2 に表示されている手数料が摘要されます。たとえば、持続時間が 1 時間の USD-KRW 通貨ペアの場合、KRW はグループ 2 に属するため 0.15% の利手数料がかかります。両方の通貨が同じグループに属する場合は、そのグループの手数料が適用されます。

FX Quote API は、次の 2 つのグループの通貨のみをサポートしています。

Availability ベータ版

The FX Quotes API is currently available in the following countries: