Solução de problemas de monetização

Esta é a documentação do Apigee Edge.
Acesse Documentação da Apigee X. informações

Este tópico fornece informações e orientações sobre como resolver problemas de monetização comum para solucionar problemas fáceis e de produção.

Desenvolvedor suspenso

Sintoma

O desenvolvedor foi suspenso e não poderá gerar receita adicional transações/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 do desenvolvedor, faça o seguinte: etapas:

  1. Execute a seguinte chamada de API para identificar o código de erro associado ao evento desenvolvedor:
    1. Se você é usuário da nuvem pública, use 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ê for usuário da nuvem privada, use 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 de erro com os seguintes códigos para determinar por que o desenvolvedor foi suspensa.

Veja também: Resumo de 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 da conta pré-paga de desenvolvedor não tiver fundos suficientes para o desenvolvedor será suspenso.

Para os desenvolvedores pós-pagos, esse erro pode ocorrer se eles excederem o limite de crédito ou se o limite de crédito definido na moeda usada estiver esgotado.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED

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

Cada desenvolvedor pode fazer um número fixo de transações com base na taxa plano de serviço comprado. Se o número de transações for excedido, o desenvolvedor será suspensa e não poderá concluir transações adicionais.

NO_CURRENT_PUBLISHABLE_ENTITY

O desenvolvedor não comprou nenhum plano de tarifas

O desenvolvedor precisa comprar um plano de preços antes de concluir qualquer transação.

Resolução

Erro

Etapas para a solução

INSUFFICIENT_FUNDS

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

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED
  1. Faça as seguintes chamadas de API para receber o plano de tarifas do desenvolvedor e dos detalhes da transação, respectivamente:
    • Execute a seguinte chamada de API para obter as datas de início e término de os 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 saber o número de chamadas transações 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:

    Pacotes > Nome do pacote > RatePlanName > Tabela de preços

    Por exemplo, se o nome do pacote for Pacote Pro e ele 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 tarifas para fazer chamadas de API.

Problemas de configuração da monetização

Sintomas

Os problemas na configuração de monetização podem se manifestar como sintomas diferentes, 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 Analytics indicam que o desenvolvedor concluiu várias transações em um período específico, mas os relatórios de monetização não listará nenhuma dessas transações.
  • As transações não estão sendo registradas

Mensagens de erro

Talvez você não veja mensagens de erro, mas vai ver os problemas explicado na página Sintomas nesta seção.

Causas possíveis

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

Diagnóstico da causa

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

    Conferir o status das transações

  2. Se você não encontrar nenhuma transação listada como SUCCESS. dentro da duração especificada, as transações não vão gerar receita.

Estas são as causas mais comuns das transações que não geram receita:

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

Política de verificação de limites de monetização não usada no proxy de API

Diagnóstico

  1. Conferir se a política de verificação de limites de monetização está anexada aos proxies da 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 nas 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 de API é monetizado (somente produtos de API monetizados são classificados e serão listados em "Transações"). Um produto monetizado tem pelo menos um plano de preços ativo disponíveis.
  2. Use a seguinte chamada de API de gerenciamento para acessar a lista de produtos de API monetizados:
    1. Se você é usuário da nuvem pública, use a API abaixo: 
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
    2. Se você for usuário da nuvem privada, use 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, pode ser o motivo pelo qual as transações não estão sendo monetizadas.

Resolução

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

  1. Configurar 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 Política de registro de transações definida incorretamente.

Política de registro de transações definida incorretamente

Diagnóstico

  1. Ativar o trace da interface para o proxy de API que tem a política de verificação de limites de monetização anexado.
  2. Selecionar uma solicitação de API específica no trace da interface.
  3. Selecione o fluxo AX do Analytics e verifique se a monetização a seguir é (mint). as variáveis de fluxo 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 trace de interface que mostra que as variáveis de fluxo do Mint estão configuradas corretamente.

  5. Se você observar um erro na variável mint.tx.status, indica que a política de registro de transações está incorreta definido.

Resolução

  1. Garantir que todas as etapas documentadas A criação da política de gravação de transações foi seguida corretamente ao criar a política de registro de transações.
  2. O valor-chave são os "critérios de sucesso da transação" definidos a política de gravação 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

Desenvolvedor não comprou plano de tarifa

Diagnóstico

  1. Use a seguinte chamada da API de gerenciamento para verificar os planos de tarifas comprados pelo desenvolvedor:
    1. Se você é um usuário de nuvem pública, use 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ê for um usuário da nuvem privada, use 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 preços com base nos requisitos dele e, em seguida, executar a transações/APIs.

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