Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Facturar a los clientes

Las apps en Mercado GitHub deben apegarse a los lineamientos de facturación de GitHub y apoyar a los servicios recomendados. El seguir nuestros lineamientos ayuda a los clientes a navegar en el proceso de facturación sin ninguna sorpresa.

En este artículo

Entender el ciclo de facturación

Los clientes pueden escoger un ciclo mensual o anual cuando compran tu app. Todos los cambios que los clientes hagan a los ciclos de facturación y a la selección de plan activaran un evento de marketplace_purchase. Puedes referirte a la carga útil del webhook de marketplace_purchase para ver qué ciclo de facturación selecciona un usuario y cuándo comienza la siguiente fecha de facturación (effective_date). Para obtener más información acerca de las cargas útiles de los webhooks, consulta la sección "eventos de webhook de Mercado GitHub".

Proporcionar servicios de facturación en la IU de tu app

Los clientes deben poder realizar las siguientes acciones desde el sitio web de tu app:

  • Los clientes deben poder modificar o cancelar sus planes de Mercado GitHub para las cuentas de organización y personales por separado.
  • Los clientes que cancelan un plan de pago que se haya comprado en Mercado GitHub deben degradar su versión automáticamente al plan gratuito de la app en caso de que éste exista. Se recomienda ampliamente la Cuando un cliente cancela una suscripción de Mercado GitHub, GitHub no desinstala la app automáticamente, así que el cliente puede esperar que las características gratuitas sigan funcionando. para permitir a los usuarios el rehabilitar su plan previo.
  • Los clientes deben poder mejorar la versión de tu app desde la IU de la misma si proporcionas una URL de mejora en este formato: https://www.github.com/marketplace/<LISTING_NAME>/upgrade/<LISTING_PLAN_NUMBER>/<CUSTOMER_ACCOUNT_ID>
  • Los clientes deben poder modificar qué usuarios tienen acceso a tu app desde el sitio web de la misma si compraron plazas (plan de precios por unidad) o si el plan ofrece colaboradores ilimitados.
  • Los clientes deben poder ver los siguientes cambios a su cuenta inmediatamente en la sección de facturación, perfil, o configuración de cuenta del sitio web de la app:
    • Plan y precios actuales.
    • Nuevos planes comprados.
    • Mejoras, degradaciones, cancelaciones y la cantidad de días restantes del periodo de prueba gratuito.
    • Cambios en los ciclos de facturación (mensual o anual).
    • Uso y recursos restantes para los planes por unidad y de tasa fija. Por ejemplo, si el plan de precios es por unidad, el sitio de tu app debería mostrar las unidades que se utilizan y las que quedan disponibles.

Servicios de facturación para mejoras, decrementos y cancelaciones

Sigue estos lineamientos para las mejoras, decrementos y cancelaciones para mantener un proceso de facturación limpio y consistente. Para obtener instrucciones más detalladas acerca de los eventos de compra de Mercado GitHub, consulta la sección "Flujos de facturación".

Puedes utilizar la llave de effective_date del webhook de marketplace_purchase para determinar cuando ocurrirá un cambio de plan y sincronizar la Lista de cuentas para un plan de vez en cuando.

Mejoras

Cuando un cliente mejora su plan de precios o cambia su ciclo de facturación de mensual a anual, deberás hacerles el cambio efectivo inmediatamente. Tienes que aplicar un descuento prorrateado para el plan nuevo y cambiar el ciclo de facturación.

En caso de que un cliente mejore su plan y el pago falle, GitHub revertirá su suscripción de Mercado GitHub a su estado previo. GitHub también enviará un correo electrónico al cliente para informarle de dicho fallo y para permitirles volver a intentar la compra. Recibirás un webhook con la acción como changed, el cual te solicitará revertir el estado de la app al plan previo.

Para obtener información acerca de los flujos de trabajo de mejora y decremento en tu app, consulta la sección "Mejorar y decrementar los planes".

Decrementos y cancelaciones

Los decrementos ocurren cuando un cliente se cambia de un plan pagado a uno gratuito, selecciona un plan con un costo menor al actual, o cambia su ciclo de facturación de anual a mensual. Cuando suceden los decrementos o cancelaciones, no necesitas proporcionar un reembolso. En vez de esto, el plan actual se mantendrá activo hasta el último día del ciclo de facturación actual. El evento marketplace_purchase se enviará cuando el nuevo plan entre en vigor al inicio del siguiente ciclo de facturación del cliente.

Cuando un cliente cancela un plan, debes:

  • Degradarlos automáticamente al plan gratuito, si es que existe.

    Cuando un cliente cancela una suscripción de Mercado GitHub, GitHub no desinstala la app automáticamente, así que el cliente puede esperar que las características gratuitas sigan funcionando.

  • Habilitarlos para mejorar el plan a través de GitHub si es que quisieran continuar con él más adelante.

Para obtener información acerca de construir flujos de trabajo de cancelación en tu app, consulta la sección "Planes de cancelación".

¿Te ayudó este documento?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.