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

# Archiva un plan de suscripción

> Archiva de forma suave un plan para que ninguna suscripción nueva pueda inscribirse. Los suscriptores existentes continúan hasta su próxima renovación.

export const SchemaLangNote = ({lang}) => {
  const text = ({
    es: "Los nombres de campos y el esquema de solicitud/respuesta que se muestran a continuación están en inglés — se generan a partir de la especificación OpenAPI. El texto explicativo de esta página está traducido.",
    pt: "Os nomes dos campos e o esquema de requisição/resposta exibidos abaixo estão em inglês — são gerados a partir da especificação OpenAPI. O texto explicativo desta página está traduzido."
  })[lang] || "Field names and the request/response schema shown below are in English — they are generated from the OpenAPI specification.";
  return <Note>{text}</Note>;
};

`DELETE /subscription/plan/{id}` archiva de forma suave un plan estableciendo su timestamp `deletedAt`. Las suscripciones existentes en el plan archivado continúan facturando normalmente. En la próxima fecha de renovación de cada suscriptor, Therius cancelará esas suscripciones en lugar de renovarlas. Ningún suscriptor nuevo puede inscribirse en un plan archivado.

<SchemaLangNote lang="es" />

<Note>
  Esto es un borrado suave — la fila del plan no se elimina de forma permanente, así que permanece en la base de datos con fines de auditoría. Sin embargo, **se excluye de los resultados de lista de `GET /subscription/plan`** una vez archivado (ese endpoint filtra los planes eliminados); consúltalo directamente vía `GET /subscription/plan/{id}` si necesitas inspeccionar un plan archivado.
</Note>

Devuelve `200 OK` con `{ "deleted": true }`.

## Errores

| Código | Significado                |
| ------ | -------------------------- |
| `404`  | Plan no encontrado.        |
| `409`  | El plan ya está archivado. |

<Warning>
  Una vez que un plan está archivado, los suscriptores existentes serán cancelados automáticamente en su próxima renovación. Migra a los suscriptores a un plan nuevo usando [change-plan](/api-reference/subscriptions/change-plan) antes de archivar si quieres que continúen facturando sin interrupción.
</Warning>

<RequestExample>
  ```bash cURL theme={"dark"}
  curl -X DELETE "https://api.therius.io/v1/subscription/plan/42?merchantCode=MERCHANT_001" \
    -H "Authorization: Bearer prv_production_your_key_here"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"dark"}
  { "deleted": true }
  ```
</ResponseExample>


## OpenAPI

````yaml DELETE /subscription/plan/{id}
openapi: 3.1.0
info:
  title: Therius API
  description: REST API for payments, subscriptions, and billing plans.
  version: 1.0.0
servers:
  - url: https://api.therius.io/v1
    description: Production
  - url: https://api-sandbox.therius.io/v1
    description: Sandbox
security:
  - bearerAuth: []
paths:
  /subscription/plan/{id}:
    delete:
      tags:
        - Plans
      summary: Archive a subscription plan
      operationId: archivePlan
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
        - name: merchantCode
          in: query
          required: true
          description: >-
            Your merchant account identifier. Validated against the Bearer key's
            merchant.
          schema:
            type: string
      responses:
        '200':
          description: Plan archived
          content:
            application/json:
              schema:
                type: object
                properties:
                  deleted:
                    type: boolean
                    example: true
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Your secret API key: `Bearer prv_production_xxx` (production) or `Bearer
        prv_sandbox_xxx` (sandbox).

````