DOCS

Retrieve an exchange rate

/

為替レートを取得

為替rateを取得する方法を学びます。

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

ZonosはZonos Checkoutや私たちのZonos Payments APIとのカスタム統合を通じて国際支払いを処理する場合にのみ、為替レートを保証します。為替レートの保証に関する詳細については、私たち利用規約を参照してください。

新しい為替rateオブジェクトを作成

2つの通貨間の新しい為替rateを取得するには、私たちのGraphQL APIを介してcreateExchangeRateミューテーションを使用できます。createExchangeRateは、sourceおよびtarget通貨コード、ならびにrateタイプをサポートしています。createExchangeRateミューテーションに関する完全なドキュメントは、私たちGraphQL APIリファレンスで見つけることができます。私たちのAPIで取得された為替レートは、組織固有です。

ミューテーション

1
2
3
4
5
6
7
8
9
10
11
12
13
14
mutation {
  exchangeRateCreate(
    input: {
      sourceCurrencyCode: GBP
      targetCurrencyCode: EUR
      type: MID_MARKET
    }
  ) {
    id
    rate
    sourceCurrencyCode
    targetCurrencyCode
  }
}

応答

1
2
3
4
5
6
7
8
9
10
{
  "data": {
    "createExchangeRate": {
      "id": "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616",
      "rate": 0.6391,
      "sourceCurrencyCode": "GBP",
      "targetCurrencyCode": "EUR"
    }
  }
}

既存の為替 rate を取得する

提供された ID を使用して exchangeRate クエリを実行することで、以前に取得した為替 rate の詳細を取得できます。これは、過去の為替 rate の詳細を確認したり、レポートやユーザーインターフェースで使用したりする場合に便利です。利用可能なフィールドの完全なリストはGraphQL API リファレンス で確認できます。

以前に作成されたレートは、取得時に更新されることはなく、元々取得された時点に固定されています。

ミューテーション

1
2
3
4
5
query {
  exchangeRate(id: "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616") {
    // Field names here...
  }
}

応答

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "data": {
    "exchangeRate": {
      "id": "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616",
      "rate": 0.6391,
      "sourceCurrencyCode": "CAD",
      "targetCurrencyCode": "GBP",
      "targetFormat": {
        "decimalDelimiter": ".",
        "symbol": "£",
        "thousandsDelimiter": ","
      }
    }
  }
}

Google 為替レートとZonos 為替レートの比較 

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

他のサイトでは、利便性のために為替rateを表示している可能性が高いですが、実際には顧客に外国通貨で請求しているわけではありません。クレジットカード会社やカードを発行する銀行は、USDで請求するサイトから購入する顧客に対して外国為替手数料や外国取引手数料を請求します。GBP(または他の通貨)で通貨が表示されていても、checkoutで表示される金額は、顧客が最終的に支払う金額ではありません。

前述のように、当社は保証された為替rateを提供しています。私たちが請求する追加手数料は、常に変動する為替市場を考慮に入れています。元々取得したrateの90日間の保証期間中に変動が発生する可能性があります。追加手数料により、顧客がcheckoutで表示され、支払う金額が最終的な総額となり、後で隠れた手数料や驚きの手数料が発生することはありません。

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