Saltar al contenido principal
Localpayment te permite cancelar las suscripciones activas cuando los clientes ya no desean continuar con sus pagos recurrentes. Esta guía detalla el proceso para cancelar una suscripción a través de la API de Localpayment, incluyendo las opciones de cancelación inmediata y al final del período de facturación.

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

Para cancelar una suscripción existente, envía una solicitud PATCH al endpoint Cancelar una suscripción.

Parámetros clave de la solicitud

La solicitud requiere varios objetos clave:

Ejemplo de solicitud

A continuación se muestra un ejemplo que utiliza curl:
curl
ImportanteUna vez cancelada una suscripción, no se puede reactivar. Si el cliente desea reanudar el servicio, deberá crear una nueva suscripción.

Paso 2: Gestionar la respuesta

Respuesta exitosa

Una cancelación exitosa devuelve la confirmación de cancelación de la suscripción:

Campos de respuesta clave

Respuesta de error

Cuando falla la cancelación de una suscripción, recibirás información de error:

Paso 3: Seguimiento del estado de la transacción

Tras cancelar 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

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. Cancelación exitosa: Cancela una suscripción activa con credenciales válidas.
  2. Suscripción ya cancelada: Intenta cancelar una suscripción que ya ha sido cancelada.
  3. Suscripción inexistente: Cancela una suscripción que no existe.
  4. Errores de autenticación: Cancelar con autenticación no válida o faltante.
  5. Notificaciones de webhook: Confirma que se han activado los webhooks de cancelación.

Próximos pasos

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

Crear nueva suscripción

Crea una nueva suscripción si el cliente desea reanudar el servicio con un plan o método de pago diferente.

Configurar webhooks

Configura webhooks para recibir notificaciones en tiempo real sobre los eventos de la suscripción.
Última modificación el 10 de noviembre de 2026