---
title: "Editar preço mínimo da assinatura"
url: "https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5/operations/editar-minimum-price-da-assinatura"
---
> Full API specification: https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5.md
# Editar preço mínimo da assinatura
`PATCH` `/subscriptions/{subscription_id}/minimum_price`
Operation ID: `editar-minimum-price-da-assinatura`
Com o verbo HTTP PATCH, através do identificador da assinatura (`subscription_id`) é possível atualizar o minimum price da assinatura.
## Path parameters
- `subscription_id` (string, required) - Código da assinatura.
Formato: `sub_XXXXXXXXXXXXXXXX`.
## Request body
Content types: `application/json`
## Responses
- `200` - 200
- `404` - 404
## OpenAPI definition
```yaml
openapi: 3.1.0
info:
title: Pagar.me v5 API (Legado)
version: 5.0.0
servers:
- url: https://api.stone.com.br/core/v5
paths:
/subscriptions/{subscription_id}/minimum_price:
patch:
summary: Editar preço mínimo da assinatura
description: Com o verbo HTTP PATCH, através do identificador da assinatura
(`subscription_id`) é possível atualizar o minimum price da assinatura.
operationId: editar-minimum-price-da-assinatura
parameters:
- name: subscription_id
in: path
description: "Código da assinatura.
Formato: `sub_XXXXXXXXXXXXXXXX`."
schema:
type: string
required: true
requestBody:
content:
application/json:
schema:
type: object
properties:
minimum_price:
type: integer
description: Valor mínimo da assinatura em centavos.
format: int32
examples:
Request Example:
value:
minimum_price: "100"
responses:
"200":
description: "200"
content:
application/json:
examples:
OK (to boleto):
value: >-
{
"id": "sub_JrvX5MpS6Niq9wzL",
"code": "6NXQF71FJD",
"start_at": "2022-03-10T00:00:00Z",
"interval": "month",
"interval_count": 1,
"billing_type": "prepaid",
"current_cycle": {
"id": "cycle_g6ek64cdmtE6JqVj",
"start_at": "2022-03-10T00:00:00Z",
"end_at": "2022-04-09T23:59:59Z",
"billing_at": "2022-03-10T00:00:00Z",
"status": "billed",
"cycle": 1
},
"next_billing_at": "2022-04-10T00:00:00Z",
"payment_method": "boleto",
"currency": "BRL",
"installments": 1,
"minimum_price": 100,
"status": "active",
"boleto_due_days": 20,
"created_at": "2022-03-10T19:42:17Z",
"updated_at": "2022-03-10T19:42:56Z",
"customer": {
"id": "cus_EbKg5vdUK9hJ0MVX",
"name": "Tony Stark",
"email": "98724a80-19ef-4208-bee4-739c138eb85f@avengers.com",
"delinquent": false,
"created_at": "2022-03-10T19:42:17Z",
"updated_at": "2022-03-10T19:42:17Z",
"phones": {}
},
"items": [
{
"id": "si_ZO5pLyltRf80ml6B",
"name": "Premium",
"description": "Sem anuncios",
"quantity": 1,
"status": "active",
"created_at": "2022-03-10T19:42:17Z",
"updated_at": "2022-03-10T19:42:17Z",
"pricing_scheme": {
"price": 1490,
"scheme_type": "unit"
}
},
{
"id": "si_yNo8g7TadToJ8bPa",
"name": "Silver",
"description": "Com anuncios",
"quantity": 1,
"status": "active",
"created_at": "2022-03-10T19:42:17Z",
"updated_at": "2022-03-10T19:42:17Z",
"pricing_scheme": {
"price": 2000,
"scheme_type": "unit"
}
}
]
}
schema:
type: object
properties:
id:
type: string
example: sub_JrvX5MpS6Niq9wzL
code:
type: string
example: 6NXQF71FJD
start_at:
type: string
example: 2022-03-10T00:00:00Z
interval:
type: string
example: month
interval_count:
type: integer
example: 1
default: 0
billing_type:
type: string
example: prepaid
current_cycle:
type: object
properties:
id:
type: string
example: cycle_g6ek64cdmtE6JqVj
start_at:
type: string
example: 2022-03-10T00:00:00Z
end_at:
type: string
example: 2022-04-09T23:59:59Z
billing_at:
type: string
example: 2022-03-10T00:00:00Z
status:
type: string
example: billed
cycle:
type: integer
example: 1
default: 0
next_billing_at:
type: string
example: 2022-04-10T00:00:00Z
payment_method:
type: string
example: boleto
currency:
type: string
example: BRL
installments:
type: integer
example: 1
default: 0
minimum_price:
type: integer
example: 100
default: 0
status:
type: string
example: active
boleto_due_days:
type: integer
example: 20
default: 0
created_at:
type: string
example: 2022-03-10T19:42:17Z
updated_at:
type: string
example: 2022-03-10T19:42:56Z
customer:
type: object
properties:
id:
type: string
example: cus_EbKg5vdUK9hJ0MVX
name:
type: string
example: Tony Stark
email:
type: string
example: 98724a80-19ef-4208-bee4-739c138eb85f@avengers.com
delinquent:
type: boolean
example: false
default: true
created_at:
type: string
example: 2022-03-10T19:42:17Z
updated_at:
type: string
example: 2022-03-10T19:42:17Z
phones:
type: object
properties: {}
items:
type: array
items:
type: object
properties:
id:
type: string
example: si_ZO5pLyltRf80ml6B
name:
type: string
example: Premium
description:
type: string
example: Sem anuncios
quantity:
type: integer
example: 1
default: 0
status:
type: string
example: active
created_at:
type: string
example: 2022-03-10T19:42:17Z
updated_at:
type: string
example: 2022-03-10T19:42:17Z
pricing_scheme:
type: object
properties:
price:
type: integer
example: 1490
default: 0
scheme_type:
type: string
example: unit
"404":
description: "404"
content:
application/json:
examples:
Result:
value: |-
{
"message": "Subscription not found."
}
schema:
type: object
properties:
message:
type: string
example: Subscription not found.
deprecated: false
security:
- sec0: []
components:
securitySchemes:
sec0:
type: http
scheme: basic
```