Solución de problemas de monetización

Estás viendo la documentación de Apigee Edge.
Ve a la Documentación de Apigee X.
información

Este tema proporciona información y orientación para solucionar problemas de monetización comúnmente observada problemas.

Se suspendió el desarrollador

Síntoma

El desarrollador está suspendido y no podrá realizar ninguna monetización adicional transacciones/llamadas a la API.

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, realiza lo siguiente: pasos:

  1. Ejecuta la siguiente llamada a la API para identificar el código de error asociado con la cuenta suspendida desarrollador:
    1. Si eres un 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 la razón por la que el desarrollador suspendida.

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

Código del motivo

Causa

Detalles

INSUFFICIENT_FUNDS

Se agotó el saldo de la cuenta de desarrollador

Si el saldo prepagado de la cuenta de desarrollador no tiene fondos suficientes para pagar de transacciones, se suspenderá al desarrollador.

En el caso de los desarrolladores que utilizan el método de pospago, este error puede ocurrir si superan el límite de crédito o si se agote 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

Todos los desarrolladores pueden realizar una cantidad fija de transacciones en función de la tarifa. plan comprado. Si se supera la cantidad de transacciones, se considera que el desarrollador es suspendida y no puede completar otras transacciones.

NO_CURRENT_PUBLISHABLE_ENTITY

El desarrollador no compró ningún plan de tarifas

Los desarrolladores deben adquirir un plan de tarifas antes de completar las transacciones.

Solución

Error

Pasos para la resolución

INSUFFICIENT_FUNDS

El desarrollador debe asegurarse de que haya suficiente saldo de cuenta 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 para desarrolladores y de la transacción, respectivamente:
    • Ejecuta la siguiente llamada a la API para obtener la fecha de inicio y finalización del 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 cargas transacciones 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 a un desarrollador puede realizar seleccionando:

    Paquetes > Nombre del paquete > Nombre del Plan de Tarifas > Hoja de tarifas

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

    Paquetes > Paquete Pro > Plan gratuito > Hoja de tarifas

NO_CURRENT_PUBLISHABLE_ENTITY

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

Problemas con la configuración de monetización

Síntomas

Los problemas con la configuración de monetización pueden manifestarse como diferentes síntomas, por ejemplo:

  • La funcionalidad de webhooks no funciona
  • No se pueden crear webhooks
  • No se activan las notificaciones de webhook
  • En los informes de monetización no se muestran transacciones. Por ejemplo: los datos de Analytics indican que el desarrollador completó muchas transacciones en un período específico, pero los informes de no enumeres 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 explican en la sección Síntomas sección.

Causas posibles

Si observas alguno de los síntomas mencionados en Síntomas, se muestra y es muy probable que no se moneticen las transacciones.

Diagnostica la causa

  1. Usa la llamada a la API de Management que se describe en la siguiente sección para y verificar si se están monetizando las transacciones.

    Consulta el estado de las transacciones

  2. Si no ves ninguna transacción con el estado SUCCESS dentro de la duración especificada, las transacciones no se monetizarán.

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

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

No se usa la Política de Verificación de Límites de Monetización en el Proxy de API

Diagnóstico

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

Solución

Adjuntar la Política de Verificación de Límites de Monetización a los proxies de API requeridos como se describe en Aplicar límites de monetización en los proxies de API

Si el problema persiste, comprueba El producto de API no está monetizado.

El producto de API no está monetizado

Diagnóstico

  1. Verifica si el producto de API está monetizado (solo están calificados los productos de API monetizados, y se en Transacciones). Un producto monetizado es aquel que tiene al menos un plan de tarifas activo disponibles.
  2. Usa la siguiente llamada a la API de administración para obtener la lista de los productos de API monetizados:
    1. Si eres un 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 su 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 registro de transacciones.

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

Si el problema persiste, verifica La política de registro de transacciones se definió incorrectamente.

La política de registro de transacciones se definió incorrectamente

Diagnóstico

  1. Habilitar el seguimiento de la IU para el proxy de API que tiene la política de verificación de límites de monetización que se adjuntan.
  2. Selecciona una solicitud a la API específica del seguimiento de la IU.
  3. Selecciona el flujo AX de Analytics y verifica si la siguiente monetización (menta) de flujo 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. Este es un ejemplo de seguimiento de la IU 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 registro de transacciones es incorrecta definido.

Solución

  1. Asegúrate de que todos los pasos documentados en Se siguió correctamente la política de registro de transacciones mientras creas la política de registro de transacciones.
  2. El par clave-valor es el “criterios de éxito de la transacción” establecido en la política de registro de transacciones. Consulta Ejemplos de configuración de criterios de éxito de transacciones en una política de registro de transacciones

Desarrollador no compró el plan de tarifas

Diagnóstico

  1. Usa la siguiente llamada a la API de Management 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 en el momento que el desarrollador completó la transacción.

Solución

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

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