您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。 信息
简介
在初始设置变现功能时，Apigee Edge 配置团队会配置币种以及贵组织支持的默认币种。
您可以查看贵组织支持的币种、添加支持的币种，或删除支持的币种（如果开发者或费率方案未使用这些币种）。
使用界面管理支持的货币
在“组织付款资料”页面的“税费和币种”部分管理支持的币种并设置默认币种。如需了解详情，请参阅使用界面管理组织付款资料。
使用 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 添加支持的货币
向 /mint//organizations/{org_name}/supported-currencies 发出 POST 请求以添加受支持的货币。对于您添加的每种受支持的币种，您都需要在请求正文中指定以下信息：
- 支持的货币的名称。该名称是货币的 ISO 4217 代码，例如 USD 代表美元。
- 显示名称。
- 说明。
- 货币是否为虚拟货币。
- 货币的状态，即货币是否可供使用。
- 要为其添加受支持货币的组织。
（可选）您可以设置：
- 支持的币种的信用额度（仅限后付费开发者）。
- 支持的币种的最低充值金额（仅限预付费开发者）。
如需了解详情，请参阅支持的货币配置属性。
例如，以下代码可为组织添加支持的货币：
curl -H "Content-Type: application/json" -X POST -d \
'{
"description": "US Dollar",
"displayName": "US Dollar",
"virtualCurrency": "false",
"name": "USD",
"organization": {
"id": "{org_name}"
},
"status": "ACTIVE"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/supported-currencies" \
-u email:password
使用 API 设置默认币种
如需为组织设置默认货币，请在修改组织付款资料时将 currency 值设置为受支持的 ISO 4217 货币代码，如使用 API 管理组织付款资料中所述。
使用 API 修改受支持的币种
如需修改受支持的货币，请向 /mint/organizations/{org_name}/{supportedCurrencyId} 发出 PUT 请求，其中 {supportedCurrency_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} 是要删除的受支持货币的标识。例如：
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 |
此属性仅适用于预付费开发者。开发者可向其预付费账号余额添加的最低金额（以指定币种为单位）。 |
不适用 | 否 |
| name |
货币的 ISO 4217 代码，例如 USD 代表美元。 |
不适用 | 是 |
| 组织 |
支持的币种对应的组织。 |
不适用 | 是 |
| 状态 |
支持的币种的状态。有效值包括：
|
不适用 | 是 |
| virtualCurrency |
指示支持的货币是否为虚拟货币。有效值包括：
|
不适用 | 是 |