DOCS

為替レートを取得

為替レートを取得

為替レートを取得する方法を学びます。

ZonosはGraphQL APIを通じて2つの通貨間の最新為替レートの取得をサポートしています。通貨間で計算する為替レートを保証します。レートは10分ごとに更新しますが、取得時点のレートを90日間保証します。

Zonosは、Zonos CheckoutまたはZonos Payments APIとのカスタム統合など、国際決済を処理する場合にのみ為替レートを保証します。為替レートの保証方法の詳細については、Terms of Serviceをご確認ください。

2つの通貨間の新しい為替レートを取得するには、GraphQL API経由で createExchangeRate mutationを使用できます。createExchangeRatesourcetarget の通貨コード、およびレートタイプをサポートします。createExchangeRate mutationの完全なドキュメントはGraphQL APIリファレンスで確認できます。APIで取得した為替レートは組織固有です。

1mutation ExchangeRateCreate($input: ExchangeRateCreateInput!) {
2 exchangeRateCreate(input: $input) {
3 id
4 rate
5 sourceCurrencyCode
6 targetCurrencyCode
7 }
8}

提供された IDexchangeRate クエリを使用して、以前に取得した為替レートの詳細を取得できます。過去の為替レート詳細の確認、レポート、UIなどでの使用に便利です。利用可能なフィールドの完全なリストはGraphQL APIリファレンスで確認できます。

以前に作成されたレートは取得時に更新されず、最初に取得された時点で固定されます。

1query ExchangeRate($id: ID!) {
2 exchangeRate(id: $id) {
3 id
4 rate
5 sourceCurrencyCode
6 targetCurrencyCode
7 targetFormat {
8 decimalDelimiter
9 symbol
10 thousandsDelimiter
11 }
12 }
13}

Google為替レートとZonos為替レート 

Googleで為替レートを使用すると、APIが提供する値とは異なる値が得られます。顧客がオンラインで見ている為替レートは消費者向けレートではありません。Googleで現在のUSDからGBPへの換算レートを検索すると、「ベンチマーク」外国為替レートが表示されます。これは大規模国際銀行が数億ドルを交換するレートですが、このレートで購入できる人はいません。Zonos為替レートを使用 しない 場合、消費者はこのベンチマークレートに外国為替会社が請求する手数料が加算されたレートを見ることになります。

他のサイトの多くは便宜上為替レートを表示していますが、実際には顧客を現地通貨で請求していません。クレジットカード会社とカード発行銀行は、USDで請求するサイトから購入する顧客に外国為替手数料と外国取引手数料を請求します。通貨がGBP(または他の通貨)で表示されていても、チェックアウト時に表示される金額が顧客が最終的に支払う金額ではありません。

前述のとおり、保証付き為替レートを提供しています。追加手数料は常に変動する為替市場を考慮しています。最初に取得したレートの90日間保証期間中に変動が発生する可能性があります。追加手数料により、チェックアウト時に顧客に表示され支払われる金額が、後から隠れた手数料や想定外の手数料なしの合計および最終コストになります。

GraphQL API ReferenceTypes, inputs, and operations used in this guide

このページは役に立ちましたか?