価格を現地化する公開プレビュー
FX Quotes API を使用して、海外の顧客に請求する価格を現地化します。
海外市場で販売する場合、顧客の現地通貨を使用すると、顧客の購入完了率と支払いのオーソリ率が向上します。ただし、このアプローチでは、いくつかの要因を考慮する必要があります。
- 決済前にサイトに表示する適切な外貨額。
- 取引に適用される現在の為替レートと外貨為替 (FX) 手数料。
- ご利用通貨で Stripe 残高に入金される金額。
- 為替レートの変更回数と現地価格への更新タイミング。
Stripe の FX Quotes API は、以下の情報を指定することで上記の考慮事項に対応します。
- 現在の為替レート: 特定の通貨ペアを対象とする Stripe の現在の為替レート。
- 拡張為替レートの見積もり: レートの見積もりは 5 分、1 時間、24 時間有効で、為替変動による不確実性を軽減します。
- 外国為替手数料情報: 取引に適用される Stripe の外国為替手数料の詳細。決済コストを差し引く前に売上処理金額を概算できます。
Terms of use 
By using the FX Quotes service, you agree to these Terms of Service.
As part of using FX Quotes you agree and understand:
- FX Quotes is currently offered as a preview service. This means Stripe offers the service “as is” and disclaims all expressed or implied warranties and guarantees around this service. You’re relying on a preview service at your own risk and Stripe isn’t liable for losses, damages, or costs arising that relate to the accuracy of the preview service.
- FX Quotes might provide you with a quote for a specific currency pair that’s valid for a time in the future. This is called an Extended Rate Quote. This quote isn’t an offer to enter into foreign exchange, and we can withdraw it at any time.
- Use of FX Quotes and Extended Rate Quotes must be used as part of a commercial transaction of goods and services you sell on Stripe.
- Extended Rate Quotes can help you manage general uncertainty in foreign exchange (FX) rates. You’re not permitted to use Extended Rate Quotes only in instances where the market FX rate is less favorable than the Extended Rate Quote.
- Stripe might add or remove supported currencies from FX Quotes at any time, without notice.
Previewで利用可能
Setup to use FX Quotes
If you’re using the SDK, refer to SDK versioning to add configurations to access preview features. If you’re not using the SDK and calling the API endpoints directly, specify a beta header along with your API version in the API call
最適な現地価格を設定する
国内の顧客に請求する金額に基づいて、他の国向けにローカライズされた価格を設定することもできます。FX Quotes が提供するレートを使用して、国内価格を他の国の現地通貨に換算できます。ローカライズ価格を決定する際には、価格と現地市場価格の端数処理を検討してください。
取引で受け取る資金がすべての市場で一定に保たれるように、Stripe の FX 手数料を顧客に渡すことを選択できます。たとえば、アメリカを拠点とする加盟店が 100 USD の商品をフランスで販売するとします。同等の価格をユーロで計算するには、exchange_ パラメーターを使用して FX 手数料を顧客に転嫁します。この手数料を転嫁したくない場合は、base_ パラメータを使用します。以下の FX Quotes のレスポンスの例は、現地通貨 EUR で表示された価格を決済通貨 USD に変換するために作成された FX Quote を示しています。
{ "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" } }
この例では、FX 手数料を顧客に転嫁するために、商品価格100 USDを為替レート (1.0791) で割って、レートをユーロ92.67 EURで取得します。FX 手数料を転嫁したくない場合は、商品価格100 USDをユーロレート91.74 EURの基本レート (1.09) で割ります。国境を越えた取引には、地域や決済手段によっては、国際的な決済手段の手数料もかかることに注意してください。詳細については、Stripe の価格ページを参照してください。
見積もり期間と料金の変更
FX Quotes API によって提供される為替レート情報を使用して価格をローカライズする場合、特定のレートが有効な期間について確実性が必要な場合があります。FX Quotes API は、lock_ に five_、hour、day の 3 つの期間を提供します。この期間は、lock_ で示されているように、有効期限が切れる前に指定されたレートを使用する限り、取引が見積もり為替レートで変換されることを示します。
FX Quotes API は、現在の本番 Stripe 為替レートの為替レート情報も提供します。このためには、lock_ = none を選択します。none 以外の lock_ を使用して見積もりを作成すると、base_ フィールドには拡張レートのプレミアムが含まれます。適切な延長料金見積もり期間を決定するには、現地価格の更新頻度と決済フロー期間を考慮してください。
時折、通貨市場はボラティリティを経験し、特定の見積もりを尊重する当社の能力に影響を与える可能性があります。決済用に作成された FX Quotes のレートしきい値は 3.5% で、送金用に作成された FX Quotes のレートしきい値は 1% です。これらのしきい値を超えてドリフトした見積もりは無効になり、lock_ は expired に変更されます。
PaymentIntent または転送に期限切れの見積もりを使用すると、payment_ または transfers_ の error. を受け取ります。これらのエラーコードを使用して、期限切れの見積もりを処理できます。
ローカライズされた価格を使用して決済を行う
イギリスを拠点とし、アメリカの顧客に販売している加盟店で、アメリカの顧客に販売している場合でも、為替レートの変動に関係なく100 GBPを確実に受け取ることを保証したいとします。このシナリオでは、hour の lock_ に FX 見積もりを取得することをお勧めします。
最新の FX 見積もりを使用して、カスタマージャーニーのどの時点でも価格をローカライズし、次の 1 時間の為替レートが固定されていることを認識します。100 GBPを受け取りたいため、USD の為替レートフィールドが 0.8 である場合、GBP 価格100 GBPを為替レートで割って125 USD額を求めます。
この125 USD金額の Payment Intents API に渡し、fx_ パラメーターを使用して決済を行うことができます。
補助単位の処理
すべての API リクエストは、通貨の補助単位の amount 値を想定しています。FX Quotes API で提供されたレートを使用した後、換算後の金額を Stripe の補助単位に変換します。詳細については、API 金額の補助単位および小数点以下なしの通貨を参照してください。
返金および不審請求の申請の通貨換算
FX Quote を使用した通貨換算による決済に不審請求の申し立てや返金が行われた場合、受取金額は現在の為替レートで取引通貨に換算し直されます。為替レートは市場により変動するため、決済時に使用されるレートと、不審請求の申し立や返金の際に使用されるレートが異なることがよくあります。加盟店残高から差し引かれる金額は現在のレートによって異なり、この金額は元の支払い額よりも多い場合と少ない場合があります。顧客には常に、レートの変動に関係なく、顧客が支払った金額と同じ額が、顧客が支払った通貨で返金されます。
見積もりの有効期限を処理する
Stripe は、有効期限または大幅なレートの変動により見積もりが無効になると、fx_ Webhook を送信します。すでに有効期限が切れている FX Quote オブジェクトを PaymentIntent API または Transfer API に関連付けると、400 のレスポンスが返されます。fx_ Webhook イベントに登録し、イベントの受信時に新しい FX Quote を作成して、新しい FX Quote オブジェクトに基づいてローカライズされた価格を更新できるようにすることをお勧めします。
仲値レートのフォールバック
カード以外の決済手段の中には、24 時間のロック期間よりも支払いの処理に時間がかかるものがあります。これらの支払いでは、FX Quote は、市場中央値の大幅な変動により、期限切れになったり、使用できなくなる可能性があります。このような場合は、市場中央値を使用して支払いを処理します。
プレミアム
ロック期間が none の FX Quotes の使用に料金はかかりません。Stripe は、拡張レート見積もりの使用に対して割増料金を請求します。このプレミアムにより、延長料金の見積もりを提供することで発生するリスクとコストをカバーできます。正確なコストは、lock_ と通貨換算の通貨ペアによって決定されます。
特定の通貨ペアでは、通貨のプレミアムが異なる場合、2 つのプレミアムのうち高い方が使用されます。たとえば、持続時間が 1 時間の USD-KRW 通貨ペアには 0.15% のプレミアムがかかります。両方の通貨が同じグループに該当する場合は、そのグループの FX 手数料が適用されます。
FX Quote は、次の 2 つのグループの通貨のみをサポートしています。
| グループ | 5 分 | 1 時間 | 24 時間 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| グループ 1: AED、AUD、AWG、BBD、BGN、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% | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||