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 solicitudPATCH 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 utilizacurl:
curl
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:- Mejora de plan exitosa: Aumento del nivel o del importe de la suscripción.
- Reducción de plan exitosa: Disminución del nivel o del importe de la suscripción.
- Actualización del método de pago: Cambio de los datos de la tarjeta.
- Actualización de la información del cliente: Modificación de los datos del cliente.
- Errores de validación: Importes no válidos, campos obligatorios faltantes.
- 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.

