管理支援的貨幣

查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件
info

簡介

在初始營利設定的過程中,Apigee Edge 設定團隊會設定貨幣,以及貴機構支援的預設貨幣。

您可以查看貴機構支援的貨幣、新增支援的貨幣,或 刪除支援的貨幣 (如果開發人員或費率方案未使用這類貨幣)。

透過 UI 管理支援的貨幣

管理支援的貨幣,並設定「稅金和幣別」的預設貨幣 部分中的「機構簡介」部分。詳情請參閱「使用 UI 管理機構設定檔」。

使用 API 管理支援的幣別

按照下列各節所述,使用 API 管理支援的貨幣。

使用 API 查看支援的貨幣

查看貴機構支援的個別貨幣或所有貨幣 享有更多支援

如要查看貴機構支援的個別貨幣,請向 /mint/organizations/{org_name}/supported-currencies/{supportedCurrencyId} 發出 GET 要求,其中 {supportedCurrency_id} 是所要查看的支援貨幣識別碼。例如:

curl -X GET -H "Accept: application/json"  \
  "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/supported-currencies/usd" \
-u email:password

如要查看貴機構支援的所有幣別,請向 /mint/organizations/{org_name}/supported-currencies 發出 GET 要求。例如:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/supported-currencies" \
  -H "Accept: application/json"  \
-u email:password

以下提供回應範例:

{
"supportedCurrency" : [ {
    "description" : "US Dollar",
    "displayName" : "US Dollar",
    "id" : "usd",
    "name" : "USD",
    "organization" : {
      ...
    "status" : "ACTIVE",
    "virtualCurrency" : false
  }, {
    "creditLimit" : 5000.0000,
    "description" : "Euro",
    "displayName" : "Euro",
    "id" : "eur",
    "name" : "EUR",
    "organization" : {
      ...
    },
    "status" : "INACTIVE",
    "virtualCurrency" : false  
  } ],
  "totalRecords" : 2
}

使用 API 設定預設幣別

currency 值設為支援的 ISO 4217 貨幣,為機構設定預設貨幣 新增程式碼,如「管理機構」一節所述 儲存設定檔

使用 API 編輯支援的貨幣

如要編輯支援的貨幣,請向 /mint/organizations/{org_name}/{supportedCurrencyId} 發出 PUT 要求,其中 {supportedCurrency_id} 是需要更新的支援貨幣 ID。您必須在要求主體中指定已更新的屬性 以及支援的貨幣 ID舉例來說,下列 API 呼叫會編輯支援貨幣的說明和顯示名稱 (範例中以粗體顯示已更新的屬性):

curl -H "Content-Type: application/json" -X PUT -d \
  '{
     "description": "United States Dollar",
     "displayName": "United States Dollar",
     "id": "usd",
     "name": "USD",
     "organization": {
       "id": "{org_name}"
     },
     "status" : "ACTIVE",
     "virtualCurrency": "false"
  }' \
  "https://api.enterprise.apigee.com/v1/mint/organization/{org_name}/supported-currencies/usd" -d \
  -u email:password

使用 API 刪除支援的貨幣

請向 /mint/organizations/{org_name}/supported-currencies/{currency_id} 發出 DELETE 要求,藉此刪除支援的幣別,其中 {currency_id} 是所要刪除的支援幣別 ID。例如:

curl -X DELETE -H "Accept: application/json"  \
  "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/supported-currencies/usd" \
  -u email:password

API 的幣別設定屬性

下表列出可使用 API 設定的設定屬性。

名稱 說明 預設 必填與否
creditLimit

這項屬性僅適用於後付款開發人員。 支援的貨幣。

不適用
說明

支援貨幣的說明。

不適用
displayName

支援幣別的顯示名稱。

不適用
minimumTopupAmount

這個屬性僅適用於預付型開發人員。開發人員能以指定幣別為預付帳戶餘額儲值的最低金額。

不適用
名稱

圖像的 ISO 4217 代碼 例如美元 (USD) 代表美元。

不適用
機構

支援幣別的機構組織。

不適用
狀態

支援貨幣的狀態。有效值包括:

  • ACTIVE:支援的貨幣。
  • 停用:不支援貨幣無法使用。
不適用
virtualCurrency

表示支援的貨幣是否為虛擬貨幣。有效值包括:

  • true:支援的貨幣為虛擬貨幣。
  • false:支援的幣別不是虛擬貨幣。
不適用