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

# Cancela o PayPerUse

> Por vezes algum contratempo na viagem do cliente pode fazê-lo querer cancelar a sua viagem, bem como os seguros atrelados a esta. Este endpoint cuida de cancelar um determinado seguro viagem para o dispositivo móvel, obedecendo a seguinte política:

- Faz-se necessário que o cancelamento seja executado até um dia antes da sua viagem;
- O cancelamento não é permitido em caso de a contratação ter acontecido há mais de 30 dias corridos.

Na requisição de cancelamento pode-se, porém não é obrigatório, enviar uma observação, seja para especificar o motivo do cancelamento ou qualquer natureza de comentário que possa ser um insumo interessante para que fique registrado.


<ParamField path="id" type="integer" initialValue="6" required>
  ID do seguro viagem que será cancelado. Este ID é retornado após a contratação do seguro.
</ParamField>

<ParamField header="Accept" type="string" initialValue="application/json" required>
  Cabeçalho que indica o tipo de conteúdo aceito na resposta. Deve ser sempre `application/json`.
</ParamField>


## OpenAPI

````yaml POST /payperuse/travels/insurances/{id}/cancel
openapi: 3.0.3
info:
  title: PayPerUse Unified API
  description: >
    API para contratação e gerenciamento de seguros viagem para dispositivos
    móveis.


    Esta API permite cotar planos, contratar seguros, processar pagamentos e
    gerenciar seguros viagem.


    Observação: Utilize sempre os cabeçalhos `Content-Type` e `Accept` como
    `application/json`
  version: 1.0.0
servers:
  - url: https://homolog.clubfix.com.br/webservice
    description: Ambiente de Homologação
  - url: https://clubfix.com.br/webservice
    description: Ambiente de Produção
security:
  - bearerAuth: []
tags:
  - name: Autenticação
    description: Endpoints para autenticação e obtenção de tokens
  - name: Cotação
    description: Endpoints para cotação de planos de seguro viagem
  - name: Contratação
    description: Endpoints para contratação de seguros viagem
  - name: Pagamento
    description: Endpoints para processamento de pagamentos
  - name: Anexos
    description: Endpoints para anexar documentos
  - name: Seguros
    description: Endpoints para consulta e gerenciamento de seguros
paths:
  /payperuse/travels/insurances/{id}/cancel:
    post:
      tags:
        - Seguros
      summary: Cancela um seguro viagem
      description: >
        Por vezes algum contratempo na viagem do cliente pode fazê-lo querer
        cancelar a sua viagem, bem como os seguros atrelados a esta. Este
        endpoint cuida de cancelar um determinado seguro viagem para o
        dispositivo móvel, obedecendo a seguinte política:


        - Faz-se necessário que o cancelamento seja executado até um dia antes
        da sua viagem;

        - O cancelamento não é permitido em caso de a contratação ter acontecido
        há mais de 30 dias corridos.


        Na requisição de cancelamento pode-se, porém não é obrigatório, enviar
        uma observação, seja para especificar o motivo do cancelamento ou
        qualquer natureza de comentário que possa ser um insumo interessante
        para que fique registrado.
      operationId: cancelInsurance
      parameters:
        - name: id
          in: path
          required: true
          description: ID do seguro viagem
          schema:
            type: integer
            example: 6
        - name: Accept
          in: header
          required: true
          schema:
            type: string
            default: application/json
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                observations:
                  type: string
                  description: Observações sobre o cancelamento
                  example: A viagem foi cancelada.
            example:
              observations: A viagem foi cancelada.
      responses:
        '200':
          description: Seguro cancelado com sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Seguro cancelado com sucesso
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/ValidationError'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  responses:
    Unauthorized:
      description: Não autorizado. Token inválido ou ausente.
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Unauthenticated.
    NotFound:
      description: Recurso não encontrado
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Resource not found.
    ValidationError:
      description: Erro de validação nos dados fornecidos
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ValidationError'
    ServerError:
      description: Erro interno do servidor
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Internal server error.
  schemas:
    ValidationError:
      type: object
      properties:
        message:
          type: string
          example: The given data was invalid.
        errors:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          example:
            credit_card:
              - validation.required_if
            credit_card.number:
              - validation.required_if
            credit_card.expirate_at:
              - validation.required_if
            credit_card.cvv:
              - validation.required_if
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Token de autenticação obtido através do endpoint de autenticação

````