Saltar al contenido principal
Localpayment te permite modificar suscripciones existentes para adaptarse a los cambios en las necesidades de los clientes, como mejorar o reducir planes, actualizar la información de facturación o cambiar la frecuencia de las suscripciones. Esta guía detalla el proceso para actualizar una suscripción a través de la API de Localpayment.

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 una suscripción

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

Parámetros clave de la solicitud

La solicitud requiere varios parámetros clave:

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 devuelve los detalles de la suscripción modificada:

Campos de respuesta clave

Respuesta de error

Cuando una solicitud falla, recibirás información detallada sobre el error:

Paso 3: Seguimiento del estado de la transacción

Tras actualizar una 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

La API de Localpayment proporciona varios códigos de estado para indicar el progreso y el resultado del pago en la respuesta.
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. Mejora de plan exitosa: Aumento del nivel o del importe de la suscripción.
  2. Reducción de plan exitosa: Disminución del nivel o del importe de la suscripción.
  3. Actualización del método de pago: Cambio de los datos de la tarjeta.
  4. Actualización de la información del cliente: Modificación de los datos del cliente.
  5. Errores de validación: Importes no válidos, campos obligatorios faltantes.
  6. Actualizaciones de estado: Gestión de webhooks y sondeo de estado

Próximos pasos

Tras actualizar una suscripción, es posible que debas realizar acciones adicionales:

Cancelar una suscripción

Finaliza las suscripciones activas cuando las actualizaciones no sean suficientes.

Gestionar webhooks de suscripciones

Configura webhooks para recibir notificaciones de los eventos de actualización de suscripciones.

Crear planes de suscripción

Crea nuevos planes que se puedan usar al actualizar suscripciones.
Última modificación el 10 de noviembre de 2026