Solução de problemas de monetização

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. informações

Este tópico fornece informações e orientações sobre como solucionar problemas de monetização comumente observados.

Suspenso pelo desenvolvedor

Sintoma

O desenvolvedor foi suspenso e não poderá fazer outras transações de monetização/chamadas de API.

Mensagens de erro

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

Diagnóstico

Para determinar o motivo da suspensão, siga estas etapas:

  1. Execute a seguinte chamada de API para identificar o código de erro associado ao desenvolvedor suspenso:
    1. Se você é usuário de nuvem pública, utilize a API abaixo: 
      curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
    2. Se você é um usuário de nuvem privada, utilize a API abaixo: 
      curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
  2. Compare o código do erro com os códigos de motivo a seguir para determinar por que o desenvolvedor foi suspenso.

Consulte também: Resumo dos códigos de motivo para desenvolvedores suspensos

Código do motivo

Causa

Detalhes

INSUFFICIENT_FUNDS

O saldo da conta de desenvolvedor está esgotado

Se o saldo pré-pago da conta do desenvolvedor não tiver fundos suficientes para outras transações, o desenvolvedor será suspenso.

Para desenvolvedores com planos pós-pagos, esse erro poderá ocorrer se o limite de crédito for excedido ou se o limite de crédito definido na moeda usada se esgotar.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED

O desenvolvedor não pode fazer outras transações

Todo desenvolvedor tem permissão para fazer um número fixo de transações com base no plano de tarifa comprado. Se o número de transações for excedido, o desenvolvedor será suspenso e não poderá concluir outras transações.

NO_CURRENT_PUBLISHABLE_ENTITY

O desenvolvedor não comprou um plano de preços

O desenvolvedor precisa adquirir um plano de tarifação antes de concluir as transações.

Resolução

Erro

Etapas para a resolução

INSUFFICIENT_FUNDS

O desenvolvedor precisa ter certeza de que há um saldo de conta ou crédito disponível suficiente para concluir outras transações.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED
  1. Faça as seguintes chamadas de API para ver os detalhes do plano de tarifa do desenvolvedor e da transação, respectivamente:
    • Execute a seguinte chamada de API para conferir as datas de início e término dos planos de preços que o desenvolvedor comprou: 
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/developers/%7Bdeveloper_id%7D/developer-accepted-rateplans
    • Execute a seguinte chamada de API para conferir o número de transações bem-sucedidas feitas pelo desenvolvedor: 
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/transactions/developers/%7Bdeveloper_email_or_id%7D

  2. Na interface do Edge, também é possível verificar o número de chamadas que um desenvolvedor pode fazer selecionando:

    Packages > PackageName > RatePlanName > Rate Card

    Por exemplo, se o nome do pacote for Pacote Pro e for um Plano sem custo financeiro, o caminho será:

    Pacotes > Pacote Pro > Plano sem custo financeiro > Tabela de preços

NO_CURRENT_PUBLISHABLE_ENTITY

O desenvolvedor precisa comprar um plano de tarifa para fazer chamadas de API.

Problemas de configuração de monetização

Sintomas

Os problemas de configuração de monetização podem se manifestar como diferentes sintomas, como:

  • A funcionalidade de webhooks não está funcionando
  • Não é possível criar webhooks
  • As notificações de webhook não estão sendo acionadas
  • Os relatórios de monetização não mostram transações. Por exemplo, os dados do Google Analytics indicam que o desenvolvedor concluiu muitas transações em um período específico, mas os Relatórios de monetização não listam nenhuma dessas transações.
  • As transações não estão sendo registradas

Mensagens de erro

Talvez nenhuma mensagem de erro seja exibida, mas os problemas serão exibidos conforme explicado na seção Sintomas.

Causas possíveis

Se você estiver vendo algum dos sintomas listados em Sintomas, é muito provável que as transações não estejam gerando receita.

Diagnosticar a causa

  1. Use a chamada da API de gerenciamento descrita na seção a seguir para verificar se as transações estão gerando receita.

    Ver o status das transações

  2. Se nenhuma transação for listada como SUCCESS dentro da duração especificada, ela não será monetizada.

Estas são as causas típicas para as transações não gerarem receita:

As seções a seguir descrevem como diagnosticar e resolver cada problema.

A política de verificação dos limites de monetização não é usada no proxy de API

Diagnóstico

  1. Confira se a política de verificação de limites de monetização está anexada aos proxies de API.
  2. Se a política não estiver anexada, esse pode ser o motivo para as transações serem listadas como FAILED.

Resolução

Anexe a política de verificação de limites de monetização aos proxies de API necessários, conforme descrito em Aplicar limites de monetização em proxies de API.

Se o problema persistir, verifique O produto da API não gera receita.

O produto da API não gera receita

Diagnóstico

  1. Verifique se o produto da API gera receita. Somente os produtos monetizados de API são classificados e serão listados em transações. Produtos monetizados são aqueles que têm pelo menos um plano de tarifas ativo disponível.
  2. Use a seguinte chamada de API de gerenciamento para conferir a lista de produtos de API monetizados:
    1. Se você é usuário de nuvem pública, utilize a API abaixo: 
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
    2. Se você é um usuário de nuvem privada, utilize a API abaixo: 
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
  3. Se o produto de API associado ao seu proxy de API não gerar receita, esse pode ser o motivo para que as transações não estejam gerando receita.

Resolução

Para gerar receita com um produto de API, siga estas etapas:

  1. Configure a política de gravação de transações.

  2. Verifique se o produto da API tem um plano de tarifas ativo.

Se o problema persistir, verifique a Política de gravação de transações definida incorretamente.

Política de gravação de transações definida incorretamente

Diagnóstico

  1. Ative o trace da interface para o proxy de API que tem a política de verificação de limites de monetização anexada.
  2. Selecione uma solicitação de API específica no trace da interface.
  3. Selecione o fluxo AX do Analytics e verifique se as seguintes variáveis de fluxo de monetização (mint) têm os valores adequados: 
    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. Este é um exemplo de rastro de interface que mostra que as variáveis de fluxo de menta estão configuradas corretamente.

  5. Se você observar um erro na variável mint.tx.status, isso vai indicar que a política de gravação de transações está definida incorretamente.

Resolução

  1. Verifique se todas as etapas documentadas em Criar política de registro de transações foram seguidas corretamente ao criar a política de gravação de transações.
  2. O valor da chave é os "critérios de sucesso da transação" definidos na política de registro de transações. Consulte Exemplos de definição de critérios de sucesso da transação em uma política de registro de transações.

O desenvolvedor não comprou um plano de tarifas

Diagnóstico

  1. Use a seguinte chamada de API de gerenciamento para verificar os planos de tarifas comprados pelo desenvolvedor:
    1. Se você é um usuário de nuvem pública, utilize a API abaixo: 
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
    2. Se você é um usuário de nuvem privada, utilize a API abaixo: 
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
  2. Com base na resposta da chamada acima, encontre o plano que estava ativo no momento em que a transação foi concluída pelo desenvolvedor.

Resolução

O desenvolvedor precisa comprar o plano de tarifas com base nos requisitos e, em seguida, executar as transações/APIs.

Se o problema persistir, entre em contato com o suporte do Apigee Edge.