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

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:

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

Para modificar una suscripción existente, envía una solicitud `PATCH` al endpoint [Actualizar una suscripción](https://docs.localpayment.com/es/reference/create-a-subscription.md).

### Parámetros clave de la solicitud

La solicitud requiere varios parámetros clave:

| Parámetro | Descripción |
| - | - |
| `amount` | Nuevo importe de la suscripción |
| `card` | Objeto de tarjeta con los datos de pago actualizados |
| `autoRecurring` | Configuración de la frecuencia de facturación y repetición |
| `discount` | Configuración de descuento que se aplicará a la suscripción |
| `retry` | Configuración de reintentos de pago para cargos fallidos |
| `dateToUpdate` | Fecha específica en la que los cambios deben entrar en vigor |
| `suspension` | Configuración de suspensión de la suscripción |
| `status` | Cambio de estado de la suscripción (p. ej., pausar/reanudar) |

### 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/payin/subscriptions/{externalId} \
     --header 'Authorization: Bearer <your_access_token>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
    "dateToUpdate": "2025-10-28",
    "amount": 1600.00,

   "autoRecurring": {
        "repetitions": "2",
        "type": "hour"
    },

   "retry": {
    "repetitions": 2,
    "intervalUnit": "day",
    "intervalValue": 1
  }
}
'

```

Consulta todos los [parámetros disponibles](https://docs.localpayment.com/es/docs/update-a-subscription.md) en la solicitud.

***

## Paso 2: Gestionar la respuesta

### Respuesta exitosa

Una actualización exitosa devuelve los detalles de la suscripción modificada:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "externalId": "564b161a-76ba-4a84-b5cf-583f2df8c377",
  "internalId": "52425bbd-b68b-4abc-9480-5ae88d53adb3",
  "status": {
    "code": "107",
    "description": "APPROVED",
    "detail": "Update subscription success"
  },
  "errors": []
}
```

### Campos de respuesta clave

| Parámetro | Descripción | Caso de uso |
| - | - | - |
| `status.code` | Código de estado actual de la suscripción. | Monitoreo del estado. |

### Respuesta de error

Cuando una solicitud falla, 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": "ERROR",
    "detail": "Invalid operation"
  }
}
```

***

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

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

La API de Localpayment proporciona varios códigos de estado para indicar el progreso y el resultado del pago en la respuesta.

| Código | Estado | Descripción |
| :- | :- | :- |
| `107` | `APPROVED` | La actualización fue aprobada y aplicada. |
| `400` | `ERROR` | La actualización de la suscripción fue rechazada. |

> [!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. **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:

> [card] [Cancelar una suscripción](https://docs.localpayment.com/es/docs/cancel-a-subscription.md)
>
> Finaliza las suscripciones activas cuando las actualizaciones no sean suficientes.

> [card] [Gestionar webhooks de suscripciones](https://docs.localpayment.com/es/docs/webhooks.md)
>
> Configura webhooks para recibir notificaciones de los eventos de actualización de suscripciones.

> [card] [Crear planes de suscripción](https://docs.localpayment.com/es/docs/create-a-subscription-plan.md)
>
> Crea nuevos planes que se puedan usar al actualizar suscripciones.


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