Se usó la API de Cloud Translation para traducir esta página.

Solución de problemas de monetización

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X. Información

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 transacciones de monetización adicionales ni 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 de la suspensión del desarrollador, sigue estos pasos:

Ejecuta la siguiente llamada a la API para identificar el código de error asociado con el desarrollador suspendido:

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

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

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 códigos de motivos 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 realizar transacciones adicionales, se suspenderá al desarrollador. En el caso de los desarrolladores de pospago, este error puede ocurrir si superan su límite de crédito o si se agota el límite de crédito establecido en la moneda que se usó.
LIMIT_VIOLATED RATE_PLAN_RATE_BAND_EXCEEDED	El desarrollador no puede realizar más transacciones	Cada desarrollador puede realizar una cantidad fija de transacciones según el plan de tarifas comprado. Si se excede la cantidad de transacciones, el desarrollador se suspenderá y no podrá completar transacciones adicionales.
NO_CURRENT_PUBLISHABLE_ENTITY	El desarrollador no compró ningún plan de tarifas	El desarrollador debe comprar un plan de tarifas antes de completar cualquier transacción.

Resolución

Error	Pasos para resolver el problema
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	Realiza las siguientes llamadas a la API para obtener el plan de tarifas y los detalles de la transacción del desarrollador, 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 que realizó el desarrollador: http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/transactions/developers/%7Bdeveloper_email_or_id%7D En la IU de Edge, también puedes seleccionar lo siguiente para verificar la cantidad de llamadas que puede realizar un desarrollador: 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: Paquetes > Paquete Pro > Plan gratuito > Hoja de tarifas
NO_CURRENT_PUBLISHABLE_ENTITY	El desarrollador debe comprar un plan de tarifas para poder hacer llamadas a la API.

Problemas de configuración de 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 transacciones. Por ejemplo, los datos de Analytics indican que el desarrollador completó muchas transacciones en un período específico, pero no se muestra ninguna en los informes de monetización.
No se registran las transacciones

Mensajes de error

Es posible que no veas 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 mencionan en Síntomas, es muy probable que las transacciones no se estén monetizando.

Diagnostica la causa

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

Consulta el estado de las transacciones
Si no ves ninguna transacción con el estado SUCCESS en la duración especificada, no se monetizan.

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

Política de verificación de límites de monetización no adjunta al proxy de API
El producto de la API no está monetizado
La política de registro de transacciones se definió de forma incorrecta
El desarrollador no compró el plan de tarifas

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

Verifica si se adjunta la Política de verificación de límites de monetización a los proxies de API.
Si no se adjunta la política, esta podría ser la razón por la que las transacciones se muestran como FAILED.

Resolución

Adjunta la Política de verificación de límites de monetización a los proxies de API obligatorios, como se describe en Aplica límites de monetización en proxies de API.

Si el problema persiste, verifica que el producto de API no esté monetizado.

El producto de API no está monetizado

Diagnóstico

Verifica si el producto de API está monetizado (solo los productos de API monetizados están clasificados y se incluirán en transacciones). Un producto monetizado es aquel que tiene al menos un plan de tarifas activo disponible.

Usa la siguiente llamada a la API de administración para obtener la lista de productos de API monetizados:

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

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

Si el producto de API asociado con tu proxy de API no está monetizado, esta podría ser la razón por la que las transacciones no se están monetizando.

Resolución

Para monetizar un producto de API, sigue estos pasos:

Configura la política de registro de transacciones.
Verifica que el producto de API tenga un plan de tarifas activo.

Si el problema persiste, revisa la Política de registro de transacciones definida de forma incorrecta.

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

Diagnóstico

Habilita el seguimiento de IU para el proxy de API que tiene adjunta la Política de verificación de límites de monetización.
Selecciona una solicitud a la API en particular del seguimiento de la IU.

Selecciona el flujo AX de Analytics y verifica si las siguientes variables de flujo de monetización (mentt) 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.

Este es un ejemplo de seguimiento de la IU que muestra que las variables de flujo de menta están configuradas correctamente.
Si observas un error en la variable mint.tx.status, significa que la política de registro de transacciones está definida de forma incorrecta.

Resolución

Asegúrate de que se hayan seguido correctamente todos los pasos documentados en Crea una política de registro de transacciones mientras se creó la política de registro de transacciones.
El valor clave es los “criterios de éxito de la transacción” que se establecen en la política de registro de transacciones. Consulta Ejemplos para configurar criterios de éxito de transacciones en una política de registro de transacciones

El desarrollador no compró el plan de tarifas

Diagnóstico

Usa la siguiente llamada a la API de administración para verificar los planes de tarifas que compró el desarrollador:

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

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

Según la respuesta de la llamada anterior, encuentra el plan que estaba activo en el momento en que el desarrollador completó la transacción.

Resolució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.