Устранение проблем с монетизацией

Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X.
информация

В этом разделе представлена ​​информация и рекомендации по устранению часто встречающихся проблем монетизации.

Разработчик приостановлен

Симптом

Разработчик заблокирован и не сможет выполнять какие-либо дополнительные транзакции монетизации или вызовы API.

Сообщения об ошибках

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

Диагностика

Чтобы определить причину блокировки разработчика, выполните следующие действия:

  1. Выполните следующий вызов API, чтобы определить код ошибки, связанный с приостановленным разработчиком:
    1. Если вы являетесь пользователем общедоступного облака, используйте приведенный ниже API:
      curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
    2. Если вы являетесь пользователем частного облака, используйте приведенный ниже API:
      curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
  2. Сравните код ошибки со следующими кодами причин, чтобы определить, почему разработчик был заблокирован.

См. также: Сводка кодов причин для приостановленных разработчиков.

Код причины

Причина

Подробности

НЕДОСТАТОЧНО_FUNDS

Баланс аккаунта разработчика исчерпан

Если на балансе предоплаченного аккаунта разработчика недостаточно средств для каких-либо дополнительных транзакций, разработчик будет заблокирован.

Для разработчиков с постоплатой эта ошибка может возникнуть, если они превышают свой кредитный лимит или если кредитный лимит, установленный для используемой валюты, исчерпан.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED

Разработчик не может совершать дальнейшие транзакции

Каждому разработчику разрешено совершать фиксированное количество транзакций в зависимости от приобретенного тарифного плана. Если количество транзакций превышено, то разработчик блокируется и не может совершать дополнительные транзакции.

NO_CURRENT_PUBLISHABLE_ENTITY

Разработчик не приобрел ни одного тарифного плана

Разработчик должен приобрести тарифный план перед выполнением каких-либо транзакций.

Разрешение

Ошибка

Действия по решению

НЕДОСТАТОЧНО_FUNDS

Разработчику необходимо убедиться, что на счету имеется достаточный баланс или доступный кредит для выполнения любых дополнительных транзакций.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED

  1. Выполните следующие вызовы API, чтобы получить тарифный план разработчика и сведения о транзакции соответственно:
    • Запустите следующий вызов 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 и это бесплатный план , то путь будет таким:

    Пакеты > Пакет Pro > Бесплатный план > Прейскурант

NO_CURRENT_PUBLISHABLE_ENTITY

Разработчику необходимо приобрести тарифный план, чтобы иметь возможность совершать вызовы API.

Проблемы с настройкой монетизации

Симптомы

Проблемы с настройкой монетизации могут проявляться в виде различных симптомов, таких как:

  • Функционал вебхуков не работает
  • Не могу создать вебхуки
  • Уведомления вебхука не запускаются
  • Отчеты о монетизации не показывают никаких транзакций. Например, данные Analytics показывают, что разработчик выполнил множество транзакций за определенный период времени, но в отчетах о монетизации ни одна из этих транзакций не указана.
  • Транзакции не регистрируются

Сообщения об ошибках

Вы можете не заметить никаких сообщений об ошибках, но вы увидите проблемы, описанные в разделе «Проблемы» .

Возможные причины

Если вы наблюдаете какой-либо из симптомов, перечисленных в разделе «Симптомы» , то, скорее всего, транзакции не монетизируются.

Диагностика причины

  1. Используйте вызов API управления, описанный в следующем разделе, чтобы проверить, монетизируются ли транзакции.

    Просмотр статуса транзакций

  2. Если в течение указанного периода вы не видите ни одной транзакции, отмеченной как УСПЕШНАЯ , значит, транзакции не монетизируются.

Типичные причины, по которым транзакции не монетизируются:

В следующих разделах описывается, как диагностировать и решать каждую проблему.

Политика проверки лимитов монетизации не используется в прокси-сервере API

Диагностика

  1. Проверьте, прикреплена ли к прокси API политика проверки лимитов монетизации.
  2. Если политика не прикреплена, это может быть причиной того, что транзакции отображаются как FAILED .

Разрешение

Прикрепите политику проверки лимитов монетизации к необходимым прокси-серверам API, как описано в разделе «Введение ограничений монетизации на прокси-серверах API» .

Если проблема не устранена, проверьте API Продукт не монетизируется .

API Продукт не монетизируется

Диагностика

  1. Проверьте, монетизируется ли продукт API (только монетизированные продукты API оцениваются и будут указаны в списке транзакций). Монетизированным продуктом считается продукт, для которого доступен хотя бы один активный тарифный план.
  2. Используйте следующий вызов API управления, чтобы получить список монетизируемых продуктов API:
    1. Если вы являетесь пользователем общедоступного облака, используйте приведенный ниже API:
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
    2. Если вы являетесь пользователем частного облака, используйте приведенный ниже API:
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
  3. Если продукт API, связанный с вашим прокси-сервером API, не монетизируется, это может быть причиной того, что транзакции не монетизируются.

Разрешение

Чтобы монетизировать продукт API, выполните следующие действия:

  1. Настройте политику записи транзакций .

  2. Убедитесь, что Продукт API имеет активный тарифный план.

Если проблема не устранена, проверьте Неправильно определена политика записи транзакций .

Неправильно определена политика записи транзакций

Диагностика

  1. Включите трассировку пользовательского интерфейса для прокси-сервера API, к которому прикреплена политика проверки ограничений монетизации.
  2. Выберите конкретный запрос API из трассировки пользовательского интерфейса.
  3. Выберите поток 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. Вот пример трассировки пользовательского интерфейса, который показывает, что переменные потока монетного двора настроены правильно.

  5. Если вы наблюдаете ошибку в переменной mint.tx.status , то это указывает на то, что политика записи транзакций определена неправильно.

Разрешение

  1. Убедитесь, что все шаги, описанные в разделе «Создание политики записи транзакций», были правильно выполнены при создании политики записи транзакций.
  2. Ключевое значение — это «критерии успеха транзакции», установленные в политике записи транзакций. См . Примеры установки критериев успешности транзакций в политике записи транзакций.

Застройщик не приобрел тарифный план

Диагностика

  1. Используйте следующий вызов API управления, чтобы проверить тарифные планы, приобретенные разработчиком:
    1. Если вы являетесь пользователем общедоступного облака, используйте приведенный ниже API:
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
    2. Если вы являетесь пользователем частного облака, используйте приведенный ниже 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 .