將資金從一種貨幣兌換為另一種貨幣

兌換是將持有的一種貨幣換成另一種貨幣的過程。

工作流程圖

對於主賬戶：

對於子賬戶：

集成指南

在本指南中，您將：

1. 獲取英鎊 (GBP) 兌歐元 (EUR) 的交易報價。
2. 透過交易英鎊來充值您的歐元餘額。

第 1 步：登入

請參閱身份驗證指南，以獲取有關啟動新 API 會話的說明。

第 2 步：獲取報價

透過調用獲取詳細匯率 /v2/rates/detailed 端點，查看使用英鎊餘額中的資金購買 10,000 歐元需要花費多少錢。

GET /v2/rates/detailed

成功後，回應有效負載將包含 Currencycloud 的報價詳細資訊以進行兌換。以下示例顯示，您可以賣出 8,059 英鎊來買入 10,000 歐元。請注意，報價僅供參考，必須預訂兌換才能鎖定匯率。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "settlement_cut_off_time":"2021-02-06T14:00:00Z",
  "currency_pair":"EURGBP",
  "client_buy_currency":"EUR",
  "client_sell_currency":"GBP",
  "client_buy_amount":"10000.00",
  "client_sell_amount":"8059.00",
  "fixed_side": "buy",
  "client_rate":"0.8059",
  "partner_rate": null,
  "core_rate":"0.8059",
  "deposit_required": false,
  "deposit_amount":"0.0",
  "deposit_currency":"GBP",
  "mid_market_rate":"0.8056"
}
    

第 3 步：兌換

如果您對報價感到滿意，您可以透過調用創建兌換 /v2/conversions/create 端點來創建兌換。

POST /v2/conversions/create
Content-Type: multipart/form-data

成功後，回應訊息的有效負載將包含您 Currencycloud 賬戶中記錄的完整兌換詳細資料。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id":"4c52215f-ca4b-4dcb-a7ae-36edc4f5db16",
  "settlement_date":"2021-02-06T14:00:00+00:00",
  "conversion_date":"2021-02-06T00:00:00+00:00",
  "short_reference":"20210202-FYYXFH",
  "creator_contact_id":"1993263d-be07-42d4-b75b-ae4ea18bcb6c",
  "account_id": "d22073a6-4c56-4980-8699-504b0c70003f",
  "currency_pair":"EURGBP",
  "status": "awaiting_funds",
  "buy_currency":"EUR",
  "sell_currency":"GBP",
  "client_buy_amount":"10000.00",
  "client_sell_amount":"8059.00",
  "fixed_side": "buy",
  "core_rate":"0.8059",
  "partner_rate": "",
  "partner_status": "funds_arrived",
  "partner_buy_amount":"0.00",
  "partner_sell_amount":"0.00",
  "client_rate":"0.8059",
  "deposit_required": false,
  "deposit_amount":"0.00",
  "deposit_currency": "",
  "deposit_status": "not_required",
  "deposit_required_at": "",
  "payment_ids": [],
  "unallocated_funds":"0.00",
  "unique_request_id": null,
  "created_at":"2021-02-02T11:41:29+00:00",
  "updated_at":"2021-02-02T11:41:29+00:00",
  "mid_market_rate":"0.8056"
}
    

只要賬戶的英鎊餘額中的資金足以支付 client_sell_amount，此兌換就會在 settlement_date 自動結算。如有必要，請使用您的現金管理器充值您的英鎊餘額。