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

# Arquive um plano de assinatura

> Arquive de forma suave um plano para que nenhuma assinatura nova possa se inscrever. Os assinantes existentes continuam até a próxima renovação deles.

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}` arquiva de forma suave um plano definindo o timestamp `deletedAt` dele. As assinaturas existentes no plano arquivado continuam faturando normalmente. Na próxima data de renovação de cada assinante, o Therius cancelará essas assinaturas em vez de renová-las. Nenhum assinante novo pode se inscrever em um plano arquivado.

<SchemaLangNote lang="pt" />

<Note>
  Isto é um soft-delete — a linha do plano não é removida de forma permanente, então ela permanece no banco de dados para fins de auditoria. No entanto, ela é **excluída dos resultados de lista de `GET /subscription/plan`** assim que arquivada (esse endpoint filtra os planos excluídos); consulte-a diretamente via `GET /subscription/plan/{id}` se precisar inspecionar um plano arquivado.
</Note>

Devolve `200 OK` com `{ "deleted": true }`.

## Erros

| Código | Significado                |
| ------ | -------------------------- |
| `404`  | Plano não encontrado.      |
| `409`  | O plano já está arquivado. |

<Warning>
  Assim que um plano é arquivado, os assinantes existentes serão cancelados automaticamente na próxima renovação deles. Migre os assinantes para um novo plano usando [change-plan](/api-reference/subscriptions/change-plan) antes de arquivar se você quiser que eles continuem faturando sem interrupção.
</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).

````