此页面由 Cloud Translation API 翻译。

管理预付费账号余额

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。信息

要管理预付款账号中的余额，您可以：

查看当前的预付款账户余额。请参阅查看预付费账号余额。
通过第三方付款服务机构根据需要重新加载账号余额（充值）。例如 Worldpay。请参阅通过第三方管理预付款余额付款服务机构。
或者，您可以手动跟踪付款或通过集成结算系统，然后调用 monetization API 来重新加载账号，例如手动管理预付款余额中的说明。
设置在预付款账号余额低于特定阈值时自动充值使用 monetization API 和第三方付款服务机构（例如 Worldpay）进行支付。此选项有助于管理费率方案的定期付款。有关信息，请参阅设置使用 API 自动重新加载预付款账号余额。

如何计算预付款账号的剩余余额？

在查看开发者或公司的预付款账号余额时（如以下部分所述），您需要：从响应中获取以下值：

amount：当前结算周期可支付的总金额。该值会在您重新加载时更新使用本部分介绍的方法处理预付款账号。
usage：当前结算周期内使用的总金额。每当符合条件的创收模式达到创收状态时，该值都会更新。或通过发放返还金额（正/负）。

注意：创收服务提供了一项预先安排的作业“开发者余额审核”，用于审核开发者余额并将用量余额重置为零。请参阅安排创收职位的时间。

您可以计算从当前结算周期的预付款账号余额中减去usage的值 amount 值。例如，如果 amount 值为 335.50，usage 值为 34，则余额的计算方式如下：

amount(335.50) - usage(34) = 229.50

使用 API 查看预付款账号的余额

以下部分介绍了如何查看开发者或使用 API。

查看开发者的预付款账号余额

如需查看开发者的预付款账号余额，请向以下 API 之一发出 GET 请求，其中 {developer_id} 是开发者的电子邮件地址：

/mint/organizations/{org_name}/developers/{developer_id}/developer-balances：返回开发者的预付款账号余额和定期设置信息。
/mint/organizations/{org_name}/developers/{developer_id}/prepaid-developer-balances：返回预付款账号余额信息，包括当前和总余额、用量、充值以及使用税。

您可以传递以下查询参数来过滤结果：

查询参数	说明
`all`	用于指定是否返回所有 API 软件包的标志。如果设置为 false，则每页返回的 API 软件包数量为由 `size` 查询参数定义。默认值为 false。
`size`	每页返回的 API 软件包数。默认值为 20。如果 `all` 查询参数设置为 `true`，则系统会忽略此参数。
`page`	要返回的页面的编号（如果内容已分页）。如果 `all` 查询参数设置为 `true`，参数会被忽略。
`currencyId`	您要用来查看预付款账号余额的币种的 ID。

例如：

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances" \
-u email:password

以下提供了一个响应示例：

{
    "developerBalance": [
        {
            "amount": 2005,
            "chargePerUsage": false,
            "id": "your-provider-id",
            "isRecurring": false,
            "supportedCurrency": {
                "description": "United States Dollars",
                "displayName": "United States Dollars",
                "id": "usd",
                "name": "USD",
                "organization": {
                    "address": [
                        {
                            "address1": "10 Almaden Blvd.",
                            "city": "San Jose",
                            "country": "US",
                            "id": "32e808d8-3a3c-4d76-a0ae-17d70a982c61",
                            "isPrimary": true,
                            "state": "CA",
                            "zip": "95113"
                        }
                    ],
                    "approveTrusted": false,
                    "approveUntrusted": false,
                    "billingCycle": "CALENDAR_MONTH",
                    "country": "US",
                    "currency": "USD",
                    "description": "my-org",
                    "groupOrganization": false,
                    "hasBillingAdjustment": false,
                    "hasBroker": false,
                    "hasSelfBilling": false,
                    "hasSeparateInvoiceForProduct": false,
                    "id": "my-org",
                    "issueNettingStmt": false,
                    "name": "my-org",
                    "nettingStmtPerCurrency": false,
                    "selfBillingAsExchOrg": false,
                    "selfBillingForAllDev": false,
                    "separateInvoiceForFees": false,
                    "status": "ACTIVE",
                    "supportedBillingType": "BOTH",
                    "taxModel": "HYBRID",
                    "timezone": "UTC"
                },
                "status": "ACTIVE",
                "virtualCurrency": false
            },
            "usage": 2.1572
        }
    ],
    "totalRecords": 1
}

查看公司的预付款账号余额

要查看某公司的预付款账号余额，请向以下地址发出 GET 请求： /mint/organizations/{org_name}/companies/{company_id}/developer-balances，其中 {company_id} 是公司的 ID。如果公司已预付款，则此请求检索当前的预付款账号余额。如果是后付费公司，请求将检索当前的信用额度。

您可以传递以下查询参数来过滤结果：

查询参数	说明
`all`	用于指定是否返回所有 API 软件包的标志。如果设置为 false，则每页返回的 API 软件包数量为由 `size` 查询参数定义。默认值为 false。
`size`	每页返回的 API 软件包数。默认值为 20。如果 `all` 查询参数设置为 `true`，则系统会忽略此参数。
`page`	要返回的页面的编号（如果内容已分页）。如果 `all` 查询参数设置为 `true`，参数会被忽略。
`currencyId`	您要用来查看预付款账号余额的币种的 ID。

例如：

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances" \
-u email:password

此响应与上面显示的响应类似，也就是查看的预付账户余额开发者。