# FX Quotes API 各地域に適応させる通貨を選択し、為替レートを固定し、手数料を顧客に転嫁するかどうかを決定します。 顧客の現地通貨で価格を表示すると、購入完了率と決済のオーソリ率が向上します。通貨を換算するには、次の点を考慮する必要があります。 - 決済前にサイトに表示する適切な外貨額。 - 取引に適用される現在の為替レートと外貨為替 (FX) 手数料。 - ご利用通貨で Stripe 残高に入金される金額。 - 為替レートの変更回数と現地価格への更新タイミング。 [FX Quotes API](https://docs.stripe.com/api/fx_quotes.md?api-version=2025-07-30.preview) には、次の通貨換算機能があります。 - **現在の為替レート:** 特定の通貨ペアを対象とする Stripe の現在の為替レート。 - **拡張為替レートの見積もり:** 5 分、1 時間、24 時間のレート見積もりを作成して、為替変動による不確実性を減らせます。 - **外国為替手数料情報:** 取引に適用される Stripe の外国為替手数料の詳細。決済コストを差し引く前に売上処理金額を概算できます。 ## 利用規約 Stripe は、特定の MCC の FX Quotes API をサポートしていません。このページの下部にあるフォームを使用して、アクセスをリクエストしてください。 FX Quotes API を利用することにより、お客様は以下の[利用規約](https://www.stripe.com/legal/fxquotes)に同意したものとみなされます。 - FX Quotes API は現在、「プレビュー版のサービス」として提供されています。これは、Stripe がサービスを「現状有姿」で提供し、このサービスに関するすべての明示的または黙示的な保証を否認するという意味です。お客様がプレビュー版サービスを利用する場合は自己責任となり、Stripe はプレビュー版サービスの正確性に関連して発生した損失、損害、費用について責任を負いません。 - FX Quotes API は、将来の一定期間有効な特定の通貨ペアの見積もりを提供する場合があります。これを、拡張レート見積もりと呼びます。この見積もりは、外国為替取引を行うためのオファーではなく、Stripe がいつでも取り消すことができるものです。 - FX Quotes API と拡張レート見積もりの機能は、貴社が Stripe で販売する商品やサービスの商取引の一部として使用する必要があります。 - 拡張レート見積もりは、外国為替 (FX) レートの一般的な不確実性に対処するのに役立ちます。特定の状況で選択的に使用しその他の状況では使用しない、という拡張レート見積もりの使い方はできません。たとえば、市場の外国為替レートが拡張レート見積もりよりも不利な場合にのみ、拡張レート見積もりを使用することはできません。 - Stripe は、予告なしにいつでも FX Quotes API のサポート対象通貨を追加または削除することがあります。 ## FX Quotes API を設定して使用する SDKを使用している場合は、[SDK versioning](https://docs.stripe.com/sdks/versioning.md#stripe-sdk-versions) を参照して、プレビュー機能にアクセスするための設定を追加してください。SDKを使わずに API エンドポイントを直接呼び出す場合は、API コールでプレビュー API バージョンを使用していることを確認してください。 #### Stripe の SDK を使用する 以下は Ruby のサンプルです。他の言語の[すべての SDK](https://docs.stripe.com/sdks.md) に対して同等のコマンドを実行できます。 ```bash gem install stripe -v 14.0.0-beta.1 ``` ```ruby require 'stripe' Stripe.api_key = <> Stripe.api_version = '2025-07-30.preview' ``` #### API を直接呼び出す ```curl curl https://api.stripe.com/v1/fx_quotes \ -u "<>:" \ -H "Stripe-Version: 2025-03-31.preview" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d to_currency=gbp \ -d "from_currencies[]=eur" \ -d lock_duration=day ``` ## 最適な現地価格を設定する FX Quotes API のレートを使用すると、自国の顧客に請求する価格に基づいて、他の国向けに適応させた価格を設定できます。地域に適応させた価格を確定する際は、現地市場の価格の微妙な違いと、最も近い整数に価格を四捨五入するかどうかを考慮してください。 顧客がどの通貨で支払っても同じ金額を受け取れるよう、Stripe の FX 手数料を顧客に渡すことができます。たとえば、アメリカを拠点とする加盟店が 100 USD の商品をフランスで販売するとします。同等の価格を EUR で計算するには、`exchange_rate` パラメーターを使用して FX 手数料を顧客に転嫁します。この手数料を転嫁したくない場合は、`base_rate` パラメータを使用します。以下のレスポンスの例は、現地通貨 EUR で表示された価格を決済通貨 USD に変換するために作成された見積もりを示しています。 ```json { "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 の[料金体系ページ](https://stripe.com/pricing)をご確認ください。 ## 見積もり期間と料金の変更 見積もりでより長い `lock_duration` をご希望の場合は、このページの下部にあるフォームを使用してお問い合わせください。 FX Quotes API によって提供される為替レート情報を使用して価格をローカライズする場合、特定のレートが有効な期間について確実性が必要な場合があります。FX Quotes API は、`lock_duration` に `five_minutes`、`hour`、`day` の 3 つの期間を提供します。この期間は、`lock_expires_at` で示されているように、有効期限が切れる前に指定されたレートを使用する限り、取引が見積もり為替レートで変換されることを示します。 FX Quotes API は、現在の本番 Stripe 為替レートの為替レート情報も提供します。このためには、`lock_duration` を `none` に設定します。 `lock_duration` が 5 分、1 時間、または 1 日に設定されている場合、`duration_premium` フィールドには[拡張レート見積もりで請求される手数料](https://docs.stripe.com/payments/currencies/localize-prices/fx-quotes-api.md#pricing)が含まれます。適切なロック期間を決定するには、現地価格が定期的に更新される方法と Checkout セッションの継続時間を考慮します。 時折、通貨市場はボラティリティを経験し、特定の見積もりを尊重する当社の能力に影響を与える可能性があります。決済用に作成された拡張レート見積もりのレートしきい値は 3.5% で、送金用に作成された拡張レート見積もりのレートしきい値は 1% です。為替レートがこれらのしきい値を超える場合、拡張レート見積もりは無効になり、`lock_status` は `expired` に変更されます。 PaymentIntent または Transfer に期限切れの見積もりを使用すると、[payment_intent_fx_quote_invalid](https://docs.stripe.com/error-codes.md#payment-intent-fx-quote-invalid) または [transfers_fx_quote_invalid](https://docs.stripe.com/error-codes.md#transfers-fx-quote-invalid) の `error.code` を受け取ります。これらのエラーコードを使用して、[期限切れの見積もりを処理](https://docs.stripe.com/payments/currencies/localize-prices/fx-quotes-api.md#webhook-integration)できます。 ## 固定為替レートを使用して価格を各地域に適応させる たとえば、イギリスを拠点とし、アメリカの顧客向けに現地価格を設定している加盟店で、USD-GBP の為替レートの変動に関係なく 100 GBP を受け取るとします。このシナリオでは、`lock_duration` を `hour` に指定して拡張レートの見積もりを取得することをお勧めします。 ```curl curl https://api.stripe.com/v1/fx_quotes \ -u "<>:" \ -d to_currency=gbp \ -d "from_currencies[]=usd" \ -d lock_duration=day ``` 欧州中央銀行の[為替レート](https://docs.stripe.com/api/fx_quotes/object.md?api-version=2025-07-30.preview#fx_quote_object-rates-%3Cfrom_currency%3E.rate_details-reference_rate_provider)を参考として表示する場合、FX Quotes オブジェクトには、[欧州中央銀行](https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html)がサポートするすべてのレートが含まれます。 USD の最新の為替レートがたとえば 0.8 の場合、価格 (100 GBP) を為替レート (0.8) で割って、現地通貨での価格 125 USD を計算します。この為替レートは今後 1 時間は固定されるため、サイトや決済ページで、アメリカの顧客に 125 USD を表示できます。 アメリカの価格125 USDを Payment Intents API に渡し、`fx_quote` パラメーターを使用して決済を行うことができます。 ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=125 \ -d currency=usd \ -d fx_quote=fxq_1QBck4FTKRd55CNDdboZYz9g ``` ### 補助単位の処理 Stripe は、[不審請求の申請または返金された支払いを換算するのは](https://docs.stripe.com/payments/currencies/localize-prices.md) は、以前の為替レートではなく、現在の為替レートで取引通貨に換算します。 すべての API リクエストは、*通貨の補助単位* (The Stripe API expects currency values using the given denomination's smallest unit represented without decimals. For example, enter 1099 to charge 10.99 USD (or any other two-decimal currency). Enter 10 to charge 10 JPY (or any other zero-decimal currency))の `amount` 値を想定しています。[FX Quotes API](https://docs.stripe.com/api/fx_quotes.md?api-version=2025-07-30.preview)] によって提供されるレートを使用した後、結果の換算された金額を Stripe の補助単位に変換します。詳細については、[API 金額の補助単位](https://docs.stripe.com/currencies.md#minor-units)と[小数点以下ゼロの通貨](https://docs.stripe.com/currencies.md#zero-decimal)を参照してください。 ## 見積もりの有効期限を処理する Stripe は、有効期限または大幅なレートの変動により見積もりが無効になると、`fx_quote.expired` Webhook を送信します。すでに有効期限が切れている `FX Quote` オブジェクトを PaymentIntent API または Transfer API に関連付けると、`400` のステータスコードが返されます。`fx_quote.expired` Webhook イベントに登録し、イベントの受信後に新しい拡張レート見積もりを作成して、新しい `FX Quote` オブジェクトに基づいてローカライズされた価格を更新できるようにすることをお勧めします。 ### 仲値レートのフォールバック [カード以外の決済手段](https://stripe.com/guides/payment-methods-guide#2-choosing-the-right-payment-methods-for-your-business)の中には、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 つのグループの通貨のみをサポートしています。 | グループ | 5 分 | 1 時間 | 24 時間 | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- | ----- | ----- | | **グループ 1:** aed、aud、awg、bbd、bhd、bmd、bsd、cad、chf、dkk、eur、gbp、hkd、idr、inr、jod、jpy、kwd、myr、nzd、omr、pab、ron、sar、sek、sgd、thb、usd、xcd、yer | 0.07% | 0.10% | 0.20% | | **グループ 2:** afn、all、amd、ang、aoa、azn、bam、bdt、bif、bnd、bob、brl、bwp、bzd、clp、cny、cop、crc、cve、czk、djf、dop、dzd、fkp、gel、gip、gmd、gnf、gtq、gyd、hnl、htg、huf、ils、isk、jmd、kes、kgs、khr、krw、kyd、kzt、lkr、lrd、mad、mdl、mga、mkd、mnt、mop、mur、mvr、mxn、mzn、 nad、nok、npr、pen、php、pkr、pln、pyg、qar、rsd、rwf、shp、std、tjs、tnd、try、ttd、twd、tzs、uah、ugx、uyu、uzs、vnd、xaf、xof、xpf、zar、zmw | 0.12% | 0.15% | 0.30% | ## 提供状況 (プレビュー) FX Quotes API は以下の国々でご利用いただけます。これを使用して[対応可能な通貨](https://docs.stripe.com/currencies.md#presentment-currencies)で現地の価格を表示できます。 - AT - BE - BG - CA - CH - CY - CZ - DE - DK - EE - ES - FI - FR - GB - GI - GR - HR - HU - IE - IT - LT - LU - LV - MT - NL - NO - PL - PT - RO - SE - SI - SK - US