---
title: "Atualizar valor da recorrência da assinatura"
method: PATCH
path: "/v2/subscriptions/{uuid}/basic-value"
tags: ["Assinaturas"]
---

# Atualizar valor da recorrência da assinatura

`PATCH /v2/subscriptions/{uuid}/basic-value`

## Request

- Base URL: `https://api.barte.com`
- URL: `https://api.barte.com/v2/subscriptions/{uuid}/basic-value`
- Auth: API key in header `X-Token-Api`
- TypeScript: <https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/docs/v2/subscriptions/:uuid/basic-value/patch.ts> (a function with typed inputs; its response is checked against the schema)

Atualiza o valor recorrência de uma assinatura existente

## Path parameters

- `uuid` string, uuid, required

## Request body

- PatchBasicValueRequest
  - `type` 'MONTHLY' | 'SEMESTER' | 'YEARLY', required: Tipo de cobrança da assinatura
  - `valuePerMonth` number, double, required: Valor mensal da assinatura

## Response `200`

Valor da recorrência da assinatura atualizado com sucesso

- SubscriptionResponse
  - `uuid` string
  - `status` 'PENDING' | 'ACTIVE' | 'DEFAULTER' | 'INACTIVE'
  - `customer` CustomerResponse
    - `document` string: Documento do cliente
    - `type` string: Tipo do documento
    - `documentCountry` string: País do documento
    - `name` string: Nome do cliente
    - `email` string, email: Email do cliente
    - `phone` string: Telefone do cliente
    - `alternativeEmail` string, email: Email alternativo
    - `integrationCustomerId` string, uuid: ID de integração do cliente
  - `startDate` string, date
  - `value` BasicValueResponse
    - `type` 'MONTHLY' | 'SEMESTER' | 'YEARLY'
    - `valuePerMonth` number, double
  - `additionalValue` AdditionalValueResponse
    - `installments` integer
    - `value` number, double
  - `paymentMethod` 'CREDIT_CARD' | 'PIX' | 'BANK_SLIP'
  - `charges` ChargeResponse[]
    - `uuid` string, uuid: UUID da cobrança
    - `title` string: Título da cobrança
    - `expirationDate` string, date: Data de expiração
    - `value` number: Valor da cobrança
    - `paymentMethod` string: Método de pagamento
    - `status` 'SCHEDULED' | 'APPROVED' | 'DECLINED' | 'PENDING': Status da cobrança
    - `customer` object
      - `document` string
      - `type` string
      - `name` string
      - `email` string, email
      - `phone` string
      - `alternativeEmail` string, email

## Other responses

- `400`: Dados inválidos
- `404`: Assinatura não encontrada

---

[API](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada.md) - [All operations](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/llms.txt) - [OpenAPI document](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/revisions/f0dd55b167f1?raw)
