Solución de problemas de monetización

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X. info

En este tema, se proporciona información y orientación para solucionar problemas de monetización que se observan con frecuencia.

Desarrollador suspendido

Síntoma

El desarrollador está suspendido y no podrá realizar ninguna transacción de monetización ni llamadas a la API adicionales.

Mensajes de error

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

Diagnóstico

Para determinar el motivo por el que se suspendió al desarrollador, sigue estos pasos:

  1. Ejecuta la siguiente llamada a la API para identificar el código de error asociado con el desarrollador suspendido :
    1. Si eres usuario de la nube pública, usa la siguiente API: 
      curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
    2. Si eres usuario de la nube privada, usa la siguiente API: 
      curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
  2. Compara el código de error con los siguientes códigos de motivos para determinar por qué se suspendió al desarrollador.

Consulta también: Resumen de los códigos de motivos para desarrolladores suspendidos

Código del motivo

Causa

Detalles

INSUFFICIENT_FUNDS

Se agotó el saldo de la cuenta del desarrollador

Si el saldo prepago de la cuenta del desarrollador no tiene fondos suficientes para realizar transacciones adicionales, se suspenderá al desarrollador.

En el caso de los desarrolladores pospagos, este error puede ocurrir si exceden su límite de crédito o si se agota el límite de crédito establecido en la moneda utilizada.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED

El desarrollador no puede realizar más transacciones

A cada desarrollador se le permite realizar una cantidad fija de transacciones según el plan de tarifas comprado. Si se excede la cantidad de transacciones, se suspende al desarrollador y no puede completar transacciones adicionales.

NO_CURRENT_PUBLISHABLE_ENTITY

El desarrollador no compró ningún plan de tarifas

Un desarrollador debe comprar un plan de tarifas antes de completar cualquier transacción.

Solución

Error

Pasos para resolver

INSUFFICIENT_FUNDS

El desarrollador debe asegurarse de que haya un saldo de cuenta suficiente o crédito disponible para completar cualquier transacción adicional.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED
  1. Realiza las siguientes llamadas a la API para obtener el plan de tarifas del desarrollador y los detalles de la transacción, respectivamente:
    • Ejecuta la siguiente llamada a la API para obtener la fecha de inicio y finalización de los planes de tarifas que compró el desarrollador: 
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/developers/%7Bdeveloper_id%7D/developer-accepted-rateplans
    • Ejecuta la siguiente llamada a la API para obtener la cantidad de transacciones correctas realizadas por el desarrollador: 
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/transactions/developers/%7Bdeveloper_email_or_id%7D

  2. En la IU de Edge, también puedes verificar la cantidad de llamadas que un desarrollador puede realizar seleccionando lo siguiente:

    Packages > PackageName > RatePlanName > Rate Card

    Por ejemplo, si el nombre del paquete es Pro Package y es un Free Plan, la ruta sería la siguiente:

    Packages > Pro Package > Free Plan > Rate Card

NO_CURRENT_PUBLISHABLE_ENTITY

El desarrollador debe comprar un plan de tarifas para poder realizar llamadas a la API.

Problemas de configuración de la monetización

Síntomas

Los problemas de configuración de la monetización pueden manifestarse como diferentes síntomas, como los siguientes:

  • La funcionalidad de Webhooks no funciona
  • No se pueden crear webhooks
  • No se activan las notificaciones de webhook
  • Los informes de monetización no muestran ninguna transacción. Por ejemplo, los datos de Analytics indican que el desarrollador completó muchas transacciones en un período específico, pero los informes de monetización no muestran ninguna de esas transacciones.
  • No se registran las transacciones

Mensajes de error

Es posible que no observes ningún mensaje de error, pero verás problemas como se explica en la sección Síntomas.

Causas posibles

Si ves alguno de los síntomas que se enumeran en Síntomas, es muy probable que las transacciones no se moneticen.

Diagnóstico de la causa

  1. Usa la llamada a la API de administración que se describe en la siguiente sección para verificar si se monetizan las transacciones.

    Consulta el estado de las transacciones

  2. Si no ves ninguna transacción que aparezca como SUCCESS dentro de la duración especificada, significa que las transacciones no se monetizan.

Las causas típicas por las que no se monetizan las transacciones son las siguientes:

En las siguientes secciones, se describe cómo diagnosticar y resolver cada problema.

La política de verificación de límites de monetización no se usa en el proxy de API

Diagnóstico

  1. Verifica si la política de verificación de límites de monetización está adjunta a los proxies de API.
  2. Si la política no está adjunta, este podría ser el motivo por el que las transacciones aparecen como FAILED.

Solución

Adjunta la política de verificación de límites de monetización a los proxies de API requeridos, como se describe en Aplica límites de monetización en proxies de API de forma forzosa.

Si el problema persiste, consulta API Product no está monetizado.

API Product no está monetizado

Diagnóstico

  1. Verifica si el producto de API está monetizado (solo se califican los productos de API monetizados y se mostrarán en las transacciones). Un producto monetizado es aquel que tiene al menos un plan de tarifas activo disponible.
  2. Usa la siguiente llamada a la API de administración para obtener la lista de productos de API monetizados:
    1. Si eres usuario de la nube pública, usa la siguiente API: 
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
    2. Si eres usuario de la nube privada, usa la siguiente API: 
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
  3. Si el producto de API asociado con tu proxy de API no está monetizado, este podría ser el motivo por el que las transacciones no se monetizan.

Solución

Para monetizar un producto de API, sigue estos pasos:

  1. Configura la política de grabación de transacciones.

  2. Verifica que el producto de API tenga un plan de tarifas activo.

Si el problema persiste, consulta La política de grabación de transacciones no está definida correctamente.

La política de grabación de transacciones no está definida correctamente

Diagnóstico

  1. Habilita el seguimiento de la IU para el proxy de API que tiene adjunta la política de verificación de límites de monetización.
  2. Selecciona una solicitud a la API específica del seguimiento de la IU.
  3. Selecciona el flujo de Analytics AX y verifica si las siguientes variables de flujo de monetización (mint) tienen los valores adecuados: 
    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. A continuación, se muestra un seguimiento de la IU de muestra que muestra que las variables de flujo de mint están configuradas correctamente.

  5. Si observas un error en la variable mint.tx.status, indica que la política de grabación de transacciones no está definida correctamente.

Solución

  1. Asegúrate de que se hayan seguido correctamente todos los pasos documentados en Crea una política de grabación de transacciones mientras creas la política de grabación de transacciones.
  2. El valor clave son los "criterios de éxito de la transacción" establecidos en la política de grabación de transacciones. Consulta Ejemplos de configuración de criterios de éxito de transacciones en una política de grabación de transacciones

El desarrollador no compró el plan de tarifas

Diagnóstico

  1. Usa la siguiente llamada a la API de administración para verificar los planes de tarifas que compró el desarrollador:
    1. Si eres usuario de la nube pública, usa la siguiente API: 
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
    2. Si eres usuario de la nube privada, usa la siguiente API: 
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
  2. Según la respuesta de la llamada anterior, busca el plan que estaba activo cuando la transacción fue completada por el desarrollador.

Solución

El desarrollador debe comprar el plan de tarifas según sus requisitos y, luego, ejecutar las transacciones o las APIs.

Si el problema persiste, comunícate con el equipo de asistencia de Apigee Edge.