Saltar al contenido principal
Localpayment te permite modificar los planes de suscripción existentes para adaptarlos a los cambios en tu estrategia de precios, ciclos de facturación u oferta de servicios. Esta guía detalla cómo actualizar un plan de suscripción mediante la API de Localpayment, garantizando que las suscripciones existentes continúen bajo los nuevos términos o de acuerdo con las políticas configuradas.

Antes de comenzar

Asegúrate de tener:

Credenciales de API

Credenciales API válidas y token de acceso para la autenticación.

Configuración de la cuenta

Configuración adecuada de la cuenta para el país de destino y verificación de la empresa.

Lista blanca de IP

Incluye en la lista blanca las direcciones IP de tus servidores para el acceso a la API.

Endpoint del webhook

Configura una URL de webhook para recibir notificaciones de pago.

Paso 1: Actualizar un plan de suscripción

Para modificar un plan de suscripción existente, envía una solicitud PATCH al endpoint Actualizar plan de suscripción.

Parámetros clave de la solicitud

La solicitud requiere varios parámetros clave:

Frecuencias de facturación admitidas

A diario

Actualización a facturación diaria. Ideal para servicios que están en transición a patrones de uso diario.Envía la propiedad autoRecurring.type con el valor: day

Mensual

Actualización a facturación mensual. Común para estandarizar los ciclos de facturación en todas las líneas de productos.Envía la propiedad autoRecurring.type con el valor: month

Personalizado (bajo demanda)

Actualización a facturación bajo demanda. Adecuado para la transición a modelos de precios basados en el uso.Envía la propiedad autoRecurring.type con el valor: custom

Ejemplo de solicitud

A continuación se muestra un ejemplo que utiliza curl:
curl
Consulta todos los parámetros disponibles en la solicitud.

Paso 2: Gestionar la respuesta

Respuesta exitosa

Una actualización exitosa del plan de suscripción devuelve una confirmación con el estado actual:

Campos de respuesta clave

Respuesta de error

Cuando falla una actualización del plan de suscripción, recibirás información detallada sobre el error:

Paso 3: Seguimiento del estado de la transacción

Tras actualizar un plan de suscripción, supervisa su estado mediante estos métodos:

Webhooks (recomendado)

Recibe notificaciones en tiempo real cuando cambie el estado de la transacción. Más eficiente para entornos de producción.

Endpoint de la API de estado

Consulta el estado de las transacciones mediante programación. Útil para sondear o recuperar notificaciones de webhook perdidas.

Vista del Business Portal

Interfaz visual para el seguimiento de transacciones. Ideal para la supervisión manual y el análisis detallado de las transacciones.

Códigos de estado comunes

Referencia completaConsulta todos los códigos de estado en nuestra documentación sobre el estado de las transacciones.

Probando tu integración

Escenarios de prueba

Verifica que tu integración gestione estos escenarios:
  1. Actualización de importe correcta: Modifica los precios del plan con valores de importe válidos.
  2. Cambio de frecuencia de facturación: Actualizar de facturación mensual a diaria o personalizada.
  3. Actualizaciones parciales: Modifica solo campos específicos sin enviar la carga útil completa.
  4. Errores de validación: Prueba con cantidades no válidas, campos obligatorios faltantes o frecuencias no admitidas.
  5. Plan inexistente: Intentar actualizar un plan que no existe.
  6. Fallos de autenticación: Realiza la prueba con tokens de acceso no válidos o caducados.

Próximos pasos

Tras actualizar un plan de suscripción, es posible que debas realizar acciones adicionales:

Crear un nuevo plan de suscripción

Configura planes de suscripción adicionales para diferentes niveles de precios o niveles de servicio.

Crear suscripción con plan actualizado

Crea nuevas suscripciones utilizando tu plan actualizado para probar los cambios.

Obtén detalles del plan de suscripción

Recupera la información actualizada del plan para verificar que se hayan aplicado todos los cambios correctamente.
Última modificación el 10 de noviembre de 2026