O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Solução de problemas de monetização

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. info

Este tópico fornece informações e orientações sobre a solução de problemas de monetização comuns.

Desenvolvedor suspenso

Sintoma

O desenvolvedor está 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 do desenvolvedor, siga estas etapas:

Execute a seguinte chamada de API para identificar o código de erro associado ao desenvolvedor suspenso:

Se você for um usuário do Public Cloud, use a API abaixo:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password

Se você for um usuário do Private Cloud, use a API abaixo:

curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password

Compare o código de erro com os seguintes códigos de motivo 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 da conta de desenvolvedor pré-paga não tiver fundos suficientes para outras transações, o desenvolvedor será suspenso. Para 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 no plano de taxas 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 nenhum plano de taxas	Um desenvolvedor precisa comprar um plano de taxas antes de concluir qualquer transação.

Resolução

Erro	Etapas de resolução
INSUFFICIENT_FUNDS	O desenvolvedor precisa garantir que haja um saldo da conta ou crédito disponível suficiente para concluir outras transações.
LIMIT_VIOLATED RATE_PLAN_RATE_BAND_EXCEEDED	Faça as seguintes chamadas de API para receber o plano de taxas do desenvolvedor e os detalhes da transação, respectivamente: Execute a seguinte chamada de API para receber a data de início e término de planos de taxas 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 receber 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 Na interface do Edge, também é possível verificar o número de chamadas que um desenvolvedor pode fazer selecionando: Pacotes > NomeDoPacote > NomeDoPlanoDeTaxas > Tabela de taxas Por exemplo, se o nome do pacote for Pacote profissional e for um Plano sem custo financeiro, o caminho será: Pacotes > Pacote profissional > Plano sem custo financeiro > Tabela de taxas
NO_CURRENT_PUBLISHABLE_ENTITY	O desenvolvedor precisa comprar um plano de taxas para poder 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 webhook 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 nenhuma transação. Por exemplo, os dados do 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 você não observe nenhuma mensagem de erro, mas verá problemas conforme explicado na seção "Sintomas" .

Causas possíveis

Se você estiver observando algum dos sintomas listados em "Sintomas", é muito provável que as transações não estejam sendo monetizadas.

Diagnóstico da causa

Use a chamada de API de gerenciamento descrita na seção a seguir para verificar se as transações estão sendo monetizadas.

Ver o status das transações
Se você não vir nenhuma transação listada como SUCESSO durante o período especificado, as transações não serão monetizadas.

As causas típicas para as transações não serem monetizadas são:

A política de verificação de limites de monetização não está anexada ao proxy de API
O APIProduct não é monetizado
Política de gravação de transações definida incorretamente
O desenvolvedor não comprou o plano de taxas

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

Verifique se a política de verificação de limites de monetização está anexada aos proxies de API.
Se a política não estiver anexada, esse poderá ser o motivo pelo qual as transações são listadas como FALHAS.

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 de API não é monetizado.

O produto de API não é monetizado

Diagnóstico

Verifique se o produto de API é monetizado (apenas os produtos de API monetizados são classificados e serão listados em transações). Um produto monetizado é aquele que tem pelo menos um plano de taxas ativo disponível.

Use a seguinte chamada de API de gerenciamento para receber a lista de produtos de API monetizados:

Se você for um usuário do Public Cloud, use a API abaixo:

curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password

Se você for um usuário do Private Cloud, use a API abaixo:

curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password

Se o produto de API associado ao proxy de API não for monetizado, esse poderá ser o motivo pelo qual as transações não estão sendo monetizadas.

Resolução

Para monetizar um produto de API, siga estas etapas:

Configurar a política de gravação de transações.
Verifique se o produto de API tem um plano de taxas ativo.

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

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

Diagnóstico

Ative o rastreamento da interface para o proxy de API que tem a política de verificação de limites de monetização anexada.
Selecione uma solicitação de API específica no rastreamento da interface.

Selecione o fluxo do Analytics AX 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.

Confira um exemplo de rastreamento da interface que mostra que as variáveis de fluxo de mint estão configuradas corretamente.
Se você observar um erro na variável mint.tx.status, isso indica que a política de gravação de transações está definida incorretamente.

Resolução

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

O desenvolvedor não comprou o plano de taxas

Diagnóstico

Use a seguinte chamada de API de gerenciamento para verificar os planos de taxas comprados pelo desenvolvedor:

Se você for um usuário do Public Cloud, 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

Se você for um usuário do Private Cloud, use a API abaixo:

curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password

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 taxas com base nos requisitos e executar as transações/APIs.

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