集成常見問題

我們整理了此文檔，以回答開發人員經常向我們提出的問題。如果您的問題未在這裡得到解答，請聯絡我們。

兌換

請求匯率時，貨幣的排序是否重要？

是。當您從獲取基準匯率 /v2/rates/find 端點獲取匯率資訊時，傳回的貨幣對字串將與輸入的 currency_pair 參數值匹配。

但是，當您從獲取詳細匯率 /v2/rates/detailed端點獲取報價時，回應中的 currency_pair 屬性值將被標準化，遵循貨幣對記號的市場慣例，而不考慮買入/賣出順序。

請參閱我們的外匯匯率指南以獲取更多資訊。

如何對兌換應用溢價？

第一步是調用獲取詳細匯率 /v2/rates/detailed 端點。

在其他回應欄位中，這將為您提供 client_rate。使用您自己的機制，您可以計算出客戶匯率的額外溢價，並顯示該溢價匯率。在執行兌換請求之前，您還應該向最終客戶顯示適當的買入或賣出金額以供批准，這也稱為「全包價格」。這就是 client_buy_amount 或 client_sell_amount，具體取決於哪個是固定的。

例如，假設您決定在一筆交易中應用 0.5% 的溢價，用英鎊餘額買入 1000 美元。調用獲取詳細匯率 /v2/rates/detailed 會傳遞以下參數：

請注意，固定方設定為「買入」。

成功的回應有效負載如下所示：

{
    "settlement_cut_off_time":"2021-10-05T15:30:00Z",
    "currency_pair":"GBPUSD",
    "client_buy_currency":"USD",
    "client_sell_currency":"GBP",
    "client_buy_amount":"1000.00",
    "client_sell_amount":"710.28",
    "fixed_side": "buy",
    "client_rate":"1.4079",
    "partner_rate":"1.4079",
    "core_rate":"1.4079",
    "deposit_required": false,
    "deposit_amount":"0.0",
    "deposit_currency":"GBP",
    "mid_market_rate":"1.4080"
}

以 1.4079 的 partner_rate 為例，您要應用 0.5% 的溢價 - 在這種情況下，這意味著從匯率中減去 0.5%，向客戶顯示匯率為 1.4009 (= 1.4079 x (1 - 0.005))。如果您是將美元賣出為英鎊，則需要在匯率上增加 0.5%。

由於買方是固定的，因此 client_sell_amount 也應該調整，並顯示給您的客戶以供批准，它也會是最終兌換請求的一部分。在我們的示例中，調整後的 client_sell_amount 將會是：

710.28 英鎊 x 0.005（溢價）= 3.55 英鎊

3.55 英鎊 + 710.28 英鎊 = 713.84 英鎊（最終的 client_sell_amount）。

當您預訂兌換時，您會傳入最終的client_sell_amount。

由於 Currencycloud 始終顯示即時匯率，我該如何處理外匯報價？

由於我們提供的是即時匯率，我們建議您在應用程式中內建計時器或倒數器，以便客戶可以在指定的時間限制內確認顯示的匯率（實時/指示性）。這有助於降低您的外匯風險。

此外，您可以選擇向客戶提供溢價匯率，有關如何實現的詳細資訊，請參閱上一個問題。對匯率添加溢價可讓您在交易中獲利，也有助於降低外匯風險。

我應該如何使用 unique_request_id 參數？

unique_request_id 可在創建兌換 /v2/conversions/create、創建支付 /v2/payments/create 和創建轉賬 /v2/transfers/create API 中作為參數使用，以便您能為交易提供唯一識別碼。其目的有兩個：一是幫助識別交易，使搜尋更容易；二是作為冪等性密鑰 - 這可確保如果您向我們發送重複請求，我們不會創建多個記錄。

支付

我可以驗證收款人的賬戶詳細資料嗎？

是，驗證收款人 /v2/beneficiaries/validate 端點將提供回饋，說明輸入的資料是否符合創建收款人的要求。我們會在創建支付時驗證收款人詳細資料。

預設 Swift 收費類型是什麼？

應用於賬戶的初始預設是 Swift Shared。預設可根據您的具體需求配置為 Shared (SHA [雙方共同承擔費用]) 或 Ours (OUR [匯款人承擔所有費用])。在支付時，如果未選擇支付收費類型，則賬戶的預設收費類型適用支付。

在我們的幫助中心文章中可以找到更多資訊。

如何管理「匯款用途」資訊？

使用我們的獲取匯款用途編碼 /v2/reference/payment_purpose_codes 端點來獲取貨幣和實體類型（公司或個人）的匯款用途編碼清單。請注意，回應中的 entity_type 是指付款人實體類型，而非收款方。

創建支付 /v2/payments/create 時，將匯款用途編碼放在 purpose_code 參數中。

匯款用途資訊僅適用於特定支付路由/貨幣/場景，如果不需要用途編碼，則請勿傳遞，因為 API 請求將被拒絕。

在我們的幫助中心文章中可以找到有關這些場景和有效用途編碼的更多資訊。

從獲取收款人要求端點到創建收款人的參數映射是什麼？

沒有一對一的映射。從獲取收款人要求 /v2/reference/beneficiary_required_details 的回應到創建收款人 /v2/beneficiaries/create 需要進行一些資料轉換（例如，acct_number >> account_number）。

管理

是否有開立特定貨幣錢包的端點？

是，可為所選貨幣調用我們的獲取餘額 /v2/balances/{currency} 端點。如果沒有該貨幣的錢包，則會創建一個。

或者，在收到收據或兌換為貨幣後，銀包就會打開。