> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Actualizar un plan de suscripción

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:

> [card] [Credenciales de API](https://docs.localpayment.com/es/docs/api-keys-and-environments.md)
>
> Credenciales API válidas y token de acceso para la autenticación.

> [card] [Configuración de la cuenta](https://docs.localpayment.com/es/docs/make-your-first-test-payment.md)
>
> Configuración adecuada de la cuenta para el país de destino y verificación de la empresa.

> [card] [Lista blanca de IP](https://docs.localpayment.com/es/docs/dashboard-whitelist-your-ips.md)
>
> Incluye en la lista blanca las direcciones IP de tus servidores para el acceso a la API.

> [card] [Endpoint del webhook](https://docs.localpayment.com/es/docs/webhooks.md)
>
> 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](https://docs.localpayment.com/es/reference/update-subscription-plan).

### Parámetros clave de la solicitud

La solicitud requiere varios parámetros clave:

| Parámetro | Descripción | Requerido |
| - | - | - |
| `amount` | Importe de facturación actualizado | ❌ |
| `autoRecurring` | Configuración actualizada para la facturación recurrente automática. | ❌ |
| `autoRecurring.repetitions` | Número actualizado de ciclos de facturación (usa `0` para recurrencia bajo demanda) | ❌ |
| `autoRecurring.type` | Unidad de frecuencia de facturación actualizada (usa `custom` para recurrencia bajo demanda) | ❌ |

### Frecuencias de facturación admitidas

> [card] 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`

> [card] 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`

> [card] 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`:

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request PATCH \
  --url 'https://api.stage.localpayment.com/api/subscriptions/plan/{internalId}' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <your_access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": 150,
    "autoRecurring": {
      "repetitions": 1,
      "type": "month"
    }
  }'
```

Consulta todos los [parámetros disponibles](https://docs.localpayment.com/es/reference/update-subscription-plan) 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:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
    "internalId": "106e9aff-96da-42e9-a9e1-4dee207e6073",
    "status": {
        "code": "100",
        "description": "ACTIVE",
        "detail": "Subscription plan was update"
    }
}
```

### Campos de respuesta clave

| Parámetro | Descripción | Caso de uso |
| - | - | - |
| `internalId` | Identificador único del plan de Localpayment. | Verifica que hayas actualizado el plan correcto. |
| `status.code` | Código de estado del plan actual. | Confirma que el plan siga activo después de las actualizaciones. |
| `status.description` | Descripción del estado legible para humanos. | Mostrar el estado en las interfaces administrativas. |
| `status.detail` | Información detallada sobre el estado. | Confirma que la operación de actualización se realizó correctamente. |

### Respuesta de error

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

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "status": {
    "code": "400",
    "description": "REJECTED",
    "detail": "amount must be greater than or equal to 1"
  }
}
```

***

## Paso 3: Seguimiento del estado de la transacción

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

> [card] [Webhooks (recomendado)](https://docs.localpayment.com/es/docs/webhooks.md)
>
> Recibe notificaciones en tiempo real cuando cambie el estado de la transacción. Más eficiente para entornos de producción.

> [card] [Endpoint de la API de estado](https://docs.localpayment.com/es/reference/get-transaction-status.md)
>
> Consulta el estado de las transacciones mediante programación. Útil para sondear o recuperar notificaciones de webhook perdidas.

> [card] [Vista del Business Portal](https://docs.localpayment.com/es/docs/dashboard-overview.md)
>
> 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

| Código | Estado | Descripción |
| :- | :- | :- |
| `100` | `ACTIVE` | El plan está activo y disponible para asociaciones suscriptoras. |
| `400` | `REJECTED` | La actualización del plan falló debido a errores de validación o parámetros no válidos. |

> [!NOTE]
>
> **Referencia completa**
>
> Consulta todos los códigos de estado en nuestra [documentación sobre el estado de las transacciones](https://docs.localpayment.com/es/reference/transaction-status-error-codes).

***

## 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:

> [card] [Crear un nuevo plan de suscripción](https://docs.localpayment.com/es/docs/create-a-subscription-plan.md)
>
> Configura planes de suscripción adicionales para diferentes niveles de precios o niveles
> de servicio.

> [card] [Crear suscripción con plan actualizado](https://docs.localpayment.com/es/docs/create-a-subscription.md)
>
> Crea nuevas suscripciones utilizando tu plan actualizado para probar los cambios.

> [card] [Obtén detalles del plan de suscripción](https://docs.localpayment.com/es/docs/get-subscription-plan.md)
>
> Recupera la información actualizada del plan para verificar que se hayan aplicado todos los cambios
> correctamente.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.