排查创收问题

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

本主题针对经常发现的创收问题提供了相关信息和指导 问题。

开发者账号已被暂停

问题

开发者账号已被暂停，且无法再进行任何其他创收 事务/API 调用。

错误消息

<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>

诊断

如需确定开发者被暂停的原因，请执行以下操作： 步骤：

  1. 执行以下 API 调用，以确定与已暂停项关联的错误代码 开发者： <ph type="x-smartling-placeholder">
      </ph>
    1. 如果您是公有云用户，请使用以下 API： 
      curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
    2. 如果您是 Private Cloud 用户，请使用以下 API： 
      curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
  2. 将错误代码与以下原因代码进行比较，以确定开发者 已暂停。

另请参阅： 开发者被暂停的原因代码

原因代码

原因

详细信息

INSUFFICIENT_FUNDS

开发者账号余额已用尽

如果预付款开发者账号的余额不足以支付任何其他费用 那么开发者会被暂停。

对于后付费开发者，如果他们超出了信用额度或 根据所用币种设置的信用额度已用尽。

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED

开发者无法再进行任何交易

每个开发者都可以根据汇率进行固定数量的交易 方案。如果超过了交易次数，则开发者 已暂停，无法完成其他交易。

NO_CURRENT_PUBLISHABLE_ENTITY

开发者尚未购买任何价格方案

开发者必须先购买价格方案，然后才能完成任何交易。

分辨率

错误

解决步骤

INSUFFICIENT_FUNDS

开发者需要确保账号余额充足，或 以完成任何其他交易。

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED
  1. 进行以下 API 调用以获取开发者费率方案 和交易详情： <ph type="x-smartling-placeholder">
      </ph>
    • 运行以下 API 调用以获取 开发者购买的费率方案： 
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/developers/%7Bdeveloper_id%7D/developer-accepted-rateplans
    • 运行以下 API 调用以获取成功事件的数量 开发者完成的交易： 
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/transactions/developers/%7Bdeveloper_email_or_id%7D

  2. 在 Edge 界面中，您还可以查看开发者 通过选择：

    包 >软件包名称 >费率方案名称 >价目表

    例如，如果软件包名称为 Pro Package， 是免费方案，则路径为：

    包 >专业版软件包 >免费方案 >价目表

NO_CURRENT_PUBLISHABLE_ENTITY

开发者必须购买费率方案才能进行 API 调用。

创收设置问题

表现

创收设置问题可能表现为不同的症状，例如：

  • 网络钩子功能不起作用
  • 无法创建网络钩子
  • 未触发网络钩子通知
  • 创收报告未显示任何交易。例如： Google Analytics 数据表明该开发者 特定时间段内的交易，但创收报告 不会列出任何此类交易。
  • 交易未记录

错误消息

您可能看不到任何错误消息，但会发现如下问题： 详情请见症状 部分。

可能的原因

如果您看到 Symptoms，则应该 相应交易很可能没有用于创收

诊断原因

  1. 使用下一部分中介绍的 Management API 调用 检查相应交易是否启用了创收功能。

    <ph type="x-smartling-placeholder"></ph> 查看交易状态

  2. 如果您没有看到任何交易列为 SUCCESS（成功） 那么这些交易就无法用于创收。

导致交易无法创收的常见原因包括：

以下部分介绍了如何诊断和解决各个问题。

API 代理中未使用的创收限制检查政策

诊断

  1. 检查 API 代理是否附加了创收限制检查政策。
  2. 如果未附加此政策，这可能就是交易被列出的原因 为 FAILED。

分辨率

将创收限制检查政策附加到所需的 API 代理。 如 <ph type="x-smartling-placeholder"></ph> 对 API 代理强制执行创收上限。

如果问题仍然存在，请查看 API 产品未用于创收。

API 产品未用于创收

诊断

  1. 检查相应 API 产品是否已启用创收功能（系统只会对用于创收的 API 产品进行分级， （列在“交易”下）。创收产品是指至少具有一个有效费率方案的产品 可用。
  2. 使用以下 Management API 调用来获取获利 API 产品的列表： <ph type="x-smartling-placeholder">
      </ph>
    1. 如果您是公有云用户，请使用以下 API： 
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
    2. 如果您是 Private Cloud 用户，请使用以下 API： 
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
  3. 如果与您的 API 代理相关联的 API 产品未用于创收，则可能是 导致相应交易未用于创收的原因。

分辨率

要通过 API 产品创收，请按以下步骤操作：

  1. <ph type="x-smartling-placeholder"></ph> 配置交易记录政策。

  2. 检查 API 产品是否具备有效的费率方案。

如果问题仍然存在，请查看 <ph type="x-smartling-placeholder"></ph> 交易记录政策定义有误。

交易记录政策定义有误

诊断

  1. 为具有创收限制检查政策的 API 代理启用界面跟踪记录 已附加。
  2. 从界面跟踪记录中选择特定 API 请求。
  3. 选择 Google Analytics AX 流程，检查是否存在以下创收情况 (mint) 流变量具有正确的值： 
    mint.tx.status - Should match the value set up for "success criteria" in the transaction recording policy for the API product being used. When tracing, the txProviderStatus in the transaction recording policy is stored in the variable 'mint.tx.status'.
mint.tx.app_id - Application id of API product.
mint.tx.prod_id - API product id.

  4. 以下界面跟踪记录示例显示了 Mint 流程变量的设置是否正确。

  5. 如果您在 mint.tx.status 变量中发现错误， 则表示交易记录政策有误 。

分辨率

  1. 确保按照 <ph type="x-smartling-placeholder"></ph> 已正确遵循创建交易记录政策 同时创建交易记录政策
  2. 键值是在 交易记录政策。 请参阅 在交易记录政策中设置交易成功标准的示例

开发者 尚未购买费率方案

诊断

  1. 使用以下 Management API 调用来验证开发者购买的费率方案： <ph type="x-smartling-placeholder">
      </ph>
    1. 如果您是公有云用户，请使用以下 API： 
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
    2. 如果您是 Private Cloud 用户，请使用以下 API： 
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
  2. 根据上述通话的回复，找到在那时生效的方案 开发者已完成交易。

分辨率

开发者必须根据自己的要求购买价格方案，然后执行 事务/API。

如果问题仍然存在，请与 Apigee Edge 支持团队联系。