DOCS

擷取匯率

擷取匯率

了解如何擷取匯率。

Zonos 支援透過我們的 GraphQL API,擷取兩種貨幣之間的最新匯率。我們保證我們計算出的貨幣匯率。雖然我們每 10 分鐘更新一次匯率,但我們保證由擷取當刻起計 90 天內的匯率有效。

Zonos 僅在我們處理國際付款的情況下保證匯率,例如透過 Zonos Checkout 或使用我們 Zonos Payments API 的自訂整合。有關我們如何保證匯率的完整詳情,請參閱我們的服務條款

如要擷取兩種貨幣之間的最新匯率,你可以透過我們的 GraphQL API 使用 createExchangeRate mutation。createExchangeRate 支援 sourcetarget 貨幣代碼,以及匯率類型。有關 createExchangeRate mutation 的完整說明,可參閱我們的 GraphQL API 參考文件。透過我們 API 擷取的匯率屬機構專屬。

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

你可以使用 exchangeRate 查詢並提供 ID,以擷取先前已擷取的匯率詳情。如果你想查看歷史匯率詳情、用於報告、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 搜尋目前的美元兌英鎊兌換率,所見的會是「基準」外匯匯率。這是大型國際銀行之間交易數億美元時所用的匯率,並非任何人都可以此匯率買賣。當不使用 Zonos 匯率時,消費者所見的匯率,是此基準匯率再加上外匯公司所收取的費用。

你所見的其他網站,很可能只是為方便起見而顯示匯率,但實際上並非以外幣向客戶收費。發卡的信用卡公司及銀行,會向在以美元計價網站購物的客戶收取外匯及跨境交易費用。即使結帳時以英鎊(或其他貨幣)顯示金額,客戶最終要支付的金額,並非結帳時所顯示的金額。

如前所述,我們提供保證匯率。我們所收取的額外費用,是為應付持續波動的外匯市場。在原先擷取匯率起計的 90 天保證期內,匯率極有可能出現變動。額外費用可確保客戶在結帳時所見及所支付的金額,就是他們最終需要支付的全部及最終費用——之後不會有任何隱藏或意外收費。

GraphQL API ReferenceTypes, inputs, and operations used in this guide
預約演示

這個頁面有幫助嗎?