Skip to main content

Requisitos para listar una app

Las apps que se encuentren en GitHub Marketplace deben cumplir con los requisitos que se detallan en esta página antes de que se pueda publicar la lista.

Los requisitos para listar una app en GitHub Marketplace varían de acuerdo con si quieres ofrecer una app gratuita o de pago.

Requisitos para todas las listas de GitHub Marketplace

Todas las listas de GitHub Marketplace deben ser para las herramientas que proporcionen valor a la comunidad de GitHub. Cuando emites tu lista para que se publique debes leer y aceptar las condiciones del Acuerdo de Desarrollador de GitHub Marketplace".

Requisitos de la experiencia del usuario para todas las apps

Todas las listas deben cumplir con los siguientes requisitos, sin importar si son para una app gratuita o de pago.

  • Las listas no deben persuadir activamente a los usuarios de que salgan de GitHub.
  • Las listas deben incluir la información de contacto válida del publicador.
  • Las listas deben tener una descripción relevante de la aplicación.
  • Las listas deben especificar un plan de precios.
  • Las apps deben proporcionar valor a los clientes e integrarse con la plataforma de alguna forma más allá de la autenticación.
  • Las apps deben estar disponibles al público en GitHub Marketplace y no pueden estar en fase beta o únicamente disponibles con invitación.
  • Las apps deben contar con eventos de webhook configurados para notificar al publicador sobre cualquier cancelación o cambio en el plan utilizando la API de GitHub Marketplace. Para obtener más información, consulta la sección "Utilizar la API de GitHub Marketplace en tu app".

Para obtener más información sobre cómo proporcionar una buena experiencia al cliente, consulta la sección "Mejores prácticas para la experiencia del cliente en las apps".

Requisitos de marca y de listado para todas las apps

Para proteger a tus clientes, te recomendamos que también sigas las mejores prácticas de seguridad. Para obtener más información, consulta la sección "Mejores prácticas de seguridad para las apps".

Consideraciones para las apps gratuitas

Se exhorta a que hayan aplicaciones gratuitas en GitHub Marketplace, y también son una gran forma de ofrecer servicios de código abierto. Si listas una versión de paga de tu app fuera de GitHub Marketplace, deberás ofrecer por lo menos un plan de pago cuando la lsitas en GitHub Marketplace.

Requisitos para las apps de pago

Para publicar un plan de pago para tu app en GitHub Marketplace, esta debe pertenecer a una organización que sea un publicador verificado. Para obtener más información sobre el proceso de verificación o de cómo transferir la propiedad de tu app, consulta la sección "Solicitar una verificación de publicador para tu organización".

Si tu app ya se publicó y eres un publicador verificado, entonces puedes publicar un plan de pago nuevo desde el editor de plan de precios. Para obtener más información, consulta la sección "Configurar planes de precios para tu listado".

Para publicar una app de pago (o una app que te ofrece un plan de pago), también debes cumplir con los siguientes requisitos:

  • Las GitHub Apps deben tener un mínimo de 100 instalaciones.
  • Las OAuth Apps deben tener un mínimo de 200 usuarios.
  • Todas las apps de pago deben gestinar los eventos de compra de GitHub Marketplace para las compras nuevas, mejoras, retrocesos, cancelaciones y pruebas gratuitas. Para obtener más información, consulta la sección "Requisitos de facturación para las apps de pago" que se encuentra más adelante.

Cuando estés listo para publicar la app en GitHub Marketplace, deberás solicitar la verificación de su listado.

Nota: Si quieres vender una app que le pertenezca a tu cuenta personal, primero necesitas transferirla a una organización y luego solicitar la verificación de un listado que haya creado la organziación. Para obtener más información sobre cómo transferir una app a una organización, consulta la sección: "Enviar tu listado para que se publique".

Requisitos de facturación para las apps de pago

Tu app no necesita administrar pagos, pero sí necesita utilizar los eventos de compra de GitHub Marketplace para administrar las compras nuevas, mejoras, retrocesos, cancelaciones y pruebas gratuitas. Para obtener más información sobre cómo integrar estos eventos en tu app, consulta la sección "Utilizar la API de GitHub Marketplace en tu app".

El utilizar la API de facturación de GitHub permite a los clientes comprar una app sin salir de GitHub y pagar por el servicio con el método de pago que ya está adjunto a su cuenta de GitHub.com.

  • Las apps deben permitir facturación mensual y anual para las compras de sus sucripciones de pago.
  • Los listados pueden ofrecer cualquier combienación de planes gratuitos y de pago. Los planes gratuitos son opcionales, pero se les fomenta. Para obtener más información, consulta la sección "Configurar un plan de precios para los listados de GitHub Marketplace".