Gestionar cambios de plan

Para más información sobre la actualización o el retroceso de versión en relación con la facturación, consulte AUTOTITLE.

Paso 1. Evento de cambio en el plan de precios

GitHub envía el webhook marketplace_purchase con la acción changed en tu aplicación, cuando un cliente efectúa cualquiera de estos cambios en su pedido GitHub Marketplace :

• Pasar a un plan de precios más caro o rebajar a uno más barato.
• Agregar o eliminar asientos en sus planes existentes.
• Cambia el ciclo de facturación.

GitHub enviará el webhook cuando el cambio surta efecto. Por ejemplo, cuando un cliente degrada un plan, GitHub envía el webhook al final del ciclo de facturación del cliente. GitHub envía un webhook a la aplicación inmediatamente cuando un cliente actualiza su plan para permitir el acceso al nuevo servicio inmediatamente. Si un cliente cambia de un ciclo mensual a uno anual, esto se considera como una mejora. Para más información sobre qué acciones se consideran una actualización o un cambio a una versión anterior, consulta AUTOTITLE.

Lea , , y del webhook para actualizar la fecha de inicio del plan, modificar el ciclo de facturación y el plan de precios del cliente. Consulta AUTOTITLE para ver un ejemplo de la carga del evento .

Si tu aplicación ofrece pruebas gratuitas, usted recibirá el webhook con la acción cuando termine la prueba gratuita. Si el periodo de prueba gratuito del cliente caduca, actualiza al cliente a la versión de pago del plan de prueba.

Paso 2. Actualizar las cuentas de usuario

Necesitarás actualizar la información de las cuentas de usuario para que se reflejen los cambios en el ciclo de facturación y en el plan de precios que el cliente hizo en su orden de GitHub Marketplace. Muestra las actualizaciones del plan de precios (para los planes de precios por unidad) y el período de facturación en el sitio web de la aplicación en Marketplace o en su interfaz de usuario cuando reciba el webhook de acción .

Cuando un cliente degrada un plan, se recomienda revisar si éste excedió los límites del mismo y contactarlos directamente en tu IU o por teléfono o correo electrónico.

Para motivar a las personas a actualizar, puedes mostrar una URL de actualización en la interfaz de usuario de tu aplicación. Consulta acerca de las direcciones URL de actualización para más información.

Pagos de mejora fallidos

En caso de que un cliente mejore su plan y el pago falle, GitHub revertirá su suscripción de GitHub Marketplace 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á un webhook con la acción changed en el que se solicita revertir al plan anterior.

Acerca de las URL de actualización

Puede redirigir a los usuarios desde la interfaz de usuario de la aplicación para actualizar en GitHub mediante una dirección URL de actualización:

https://www.github.com/marketplace/<LISTING_NAME>/upgrade/<LISTING_PLAN_NUMBER>/<CUSTOMER_ACCOUNT_ID>

Por ejemplo, si notas que el cliente tiene un plan de 5 personas y necesita cambiar a uno de 10, puedes mostrar un boton en la IU de tu app, el cual diga "Te mostramos como mejorar tu plan", o bien, mostrar un letrero con un enlace a la URL de mejora. La URL de actualización dirigirá al cliente a la página de confirmación de actualización para el plan de lista.

Use el [nombre del ítem] para el plan que el cliente quiera comprar. Al crear nuevos planes de precios, reciben un identificador que es único para cada plan de tu lista, y un identificador que es único para cada plan de GitHub Marketplace. Puede encontrar estos números cuando lista los planes, lo que identifica los planes de precios de su listado. Usa el y el punto de conexión para obtener el .