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

# Suspender assinatura

> Suspende uma assinatura existente, interrompendo temporariamente as cobranças recorrentes. Esta operação é útil quando o cliente precisa de uma pausa temporária no serviço, mas deseja manter a assinatura para reativação futura.

**Impacto da suspensão:**
- As cobranças recorrentes são interrompidas imediatamente
- O cliente não será mais cobrado enquanto a assinatura estiver suspensa
- A assinatura mantém seu histórico e configurações originais
- Pode ser reativada a qualquer momento através da rota de reativação

**Observações importantes:**
- A suspensão é diferente do cancelamento, pois permite reativação posterior
- O período de suspensão não conta para a duração total da assinatura
- O cliente mantém acesso aos benefícios até o final do período já pago
- A reativação pode ser feita a qualquer momento, retomando as cobranças no próximo ciclo



## OpenAPI

````yaml POST /subscriptions/{subscriptionId}/suspend
openapi: 3.1.0
info:
  title: OpenAPI Super APIs
  description: Documentação das APIs destinada a companhias da Super Pagamentos
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://sandbox-api.superpagamentos.com
    description: Ambiente de desenvolvimento
  - url: https://api.superpagamentos.com
    description: Ambiente de produção
security: []
paths:
  /subscriptions/{subscriptionId}/suspend:
    post:
      description: >-
        Suspende uma assinatura existente, interrompendo temporariamente as
        cobranças recorrentes. Esta operação é útil quando o cliente precisa de
        uma pausa temporária no serviço, mas deseja manter a assinatura para
        reativação futura.


        **Impacto da suspensão:**

        - As cobranças recorrentes são interrompidas imediatamente

        - O cliente não será mais cobrado enquanto a assinatura estiver suspensa

        - A assinatura mantém seu histórico e configurações originais

        - Pode ser reativada a qualquer momento através da rota de reativação


        **Observações importantes:**

        - A suspensão é diferente do cancelamento, pois permite reativação
        posterior

        - O período de suspensão não conta para a duração total da assinatura

        - O cliente mantém acesso aos benefícios até o final do período já pago

        - A reativação pode ser feita a qualquer momento, retomando as cobranças
        no próximo ciclo
      parameters:
        - name: subscriptionId
          in: path
          description: ID da assinatura que será suspensa
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Assinatura suspensa com sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                        example: b84f592c-7db6-44fa-b783-4a327156880b
                      status:
                        type: string
                        example: SUSPENDED
                  message:
                    type: string
                    example: Assinatura suspensa com sucesso
        '400':
          description: Erro ao suspender assinatura
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      message:
                        type: string
                      returnCode:
                        type: integer
              examples:
                Assinatura não encontrada:
                  value:
                    data:
                      message: Assinatura não encontrada
                      returnCode: -7601
                Assinatura já suspensa:
                  value:
                    data:
                      message: Assinatura já está suspensa
                      returnCode: -7617
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Token JWT gerado na rota de autenticação (/auth). Deve ser enviado no
        formato: Bearer <token>

````