Zonos 支援透過 GraphQL API 在兩種貨幣之間即時取得匯率。我們保證所計算的匯率準確無誤。雖然我們每 10 分鐘更新一次匯率,但我們保證取得時起 90 天內的匯率有效。
Zonos 僅在我們處理國際付款的情況下保證匯率,例如透過 Zonos Checkout 或與 Zonos Payments API 的自訂整合。如需了解我們如何保證匯率的完整詳細資料,請參閱我們的 服務條款。
若要在兩種貨幣之間取得新的匯率,您可以透過 GraphQL API 使用 createExchangeRate mutation。createExchangeRate 支援 source 和 target 貨幣代碼,以及匯率類型。有關 createExchangeRate mutation 的完整文件,請參閱我們的 GraphQL API 參考。透過 API 取得的匯率是特定於組織的。
createExchangeRate
source
target
mutation ExchangeRateCreate($input: ExchangeRateCreateInput!) {
exchangeRateCreate(input: $input) {
id
rate
sourceCurrencyCode
targetCurrencyCode
}
您可以使用 exchangeRate 查詢搭配提供的 ID 來檢索先前取得的匯率詳細資料。如果您想檢視歷史匯率詳細資料、將其用於報表、UI 等,這很有用。您可以在 GraphQL API 參考 上看到可用欄位的完整清單。
exchangeRate
ID
先前建立的匯率在您檢索時不會重新整理,它們會釘選到原始取得的時間。
query ExchangeRate($id: ID!) {
exchangeRate(id: $id) {
targetFormat {
decimalDelimiter
symbol
thousandsDelimiter
當您使用 Google 取得匯率時,您將獲得與我們 API 提供的不同值。您的客戶在線上看到的匯率不是消費者匯率。如果您 Google 當前的美元對英鎊兌換率,您會看到「基準」外匯匯率。這是大型國際銀行交換數億美元時的匯率,但沒有人可以以此匯率購買。當未使用 Zonos 匯率時,消費者會看到此基準匯率加上外匯公司收取的費用。
其他網站很可能為了方便起見而顯示匯率,但它們實際上並未以外幣向客戶收費。對於從以美元收費的網站購買的客戶,信用卡公司和發卡銀行將收取外匯和外幣交易費。儘管他們以英鎊(或任何其他貨幣)顯示貨幣,但在結帳時向他們顯示的金額並不是客戶最終將支付的金額。
如前所述,我們提供有保證的匯率。我們收取的額外費用考慮到了不斷波動的匯市。在原始取得匯率的 90 天保證期內,很可能會發生變化。額外費用確保客戶在結帳時顯示和支付的金額是他們將支付的總費用和最終費用——以後不會有隱藏或意外費用。
ExchangeRateCreateInput
exchangeRateCreate
檢索匯率
檢索匯率
了解如何檢索匯率。Zonos 支援透過 GraphQL API 在兩種貨幣之間即時取得匯率。我們保證所計算的匯率準確無誤。雖然我們每 10 分鐘更新一次匯率,但我們保證取得時起 90 天內的匯率有效。
Zonos 僅在我們處理國際付款的情況下保證匯率,例如透過 Zonos Checkout 或與 Zonos Payments API 的自訂整合。如需了解我們如何保證匯率的完整詳細資料,請參閱我們的 服務條款。
建立新的匯率物件
若要在兩種貨幣之間取得新的匯率,您可以透過 GraphQL API 使用
createExchangeRatemutation。createExchangeRate支援source和target貨幣代碼,以及匯率類型。有關createExchangeRatemutation 的完整文件,請參閱我們的 GraphQL API 參考。透過 API 取得的匯率是特定於組織的。mutation ExchangeRateCreate($input: ExchangeRateCreateInput!) {exchangeRateCreate(input: $input) {idratesourceCurrencyCodetargetCurrencyCode}}檢索現有的匯率
您可以使用
exchangeRate查詢搭配提供的ID來檢索先前取得的匯率詳細資料。如果您想檢視歷史匯率詳細資料、將其用於報表、UI 等,這很有用。您可以在 GraphQL API 參考 上看到可用欄位的完整清單。先前建立的匯率在您檢索時不會重新整理,它們會釘選到原始取得的時間。
query ExchangeRate($id: ID!) {exchangeRate(id: $id) {idratesourceCurrencyCodetargetCurrencyCodetargetFormat {decimalDelimitersymbolthousandsDelimiter}}}Google 匯率與 Zonos 匯率的比較
當您使用 Google 取得匯率時,您將獲得與我們 API 提供的不同值。您的客戶在線上看到的匯率不是消費者匯率。如果您 Google 當前的美元對英鎊兌換率,您會看到「基準」外匯匯率。這是大型國際銀行交換數億美元時的匯率,但沒有人可以以此匯率購買。當未使用 Zonos 匯率時,消費者會看到此基準匯率加上外匯公司收取的費用。
其他網站很可能為了方便起見而顯示匯率,但它們實際上並未以外幣向客戶收費。對於從以美元收費的網站購買的客戶,信用卡公司和發卡銀行將收取外匯和外幣交易費。儘管他們以英鎊(或任何其他貨幣)顯示貨幣,但在結帳時向他們顯示的金額並不是客戶最終將支付的金額。
如前所述,我們提供有保證的匯率。我們收取的額外費用考慮到了不斷波動的匯市。在原始取得匯率的 90 天保證期內,很可能會發生變化。額外費用確保客戶在結帳時顯示和支付的金額是他們將支付的總費用和最終費用——以後不會有隱藏或意外費用。
ExchangeRateCreateInput
exchangeRateCreate
這個頁面有幫助嗎?