Skip to main content
PATCH
/
api
/
subscription-prices
/
{id}
Atualizar Preço de Assinatura
curl --request PATCH \
  --url https://garu.com.br/api/subscription-prices/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "amount": 123,
  "billingInterval": "<string>",
  "trialDays": 123,
  "isActive": true
}
'

​
Visão Geral

Atualize um preço de assinatura existente. Alterações de valor e período de teste afetam apenas novas assinaturas. Assinaturas existentes mantêm os valores originais.

​
Exemplo de Requisição

curl -X PATCH https://garu.com.br/api/subscription-prices/456 \
  -H "Authorization: Bearer sk_test_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Plano Mensal Premium",
    "amount": 59.90,
    "isActive": true
  }'

​
Parâmetros

​
name
string
Nome do plano.
​
amount
number
Valor em Reais (afeta apenas novas assinaturas).
​
billingInterval
string
Intervalo de cobrança: daily, weekly, monthly, annually (afeta apenas novas assinaturas).
​
trialDays
integer
Dias de teste gratuito (afeta apenas novas assinaturas).
​
isActive
boolean
Se o plano está disponível para novos assinantes.

​
Campos Atualizáveis

CampoDescriçãoAfeta assinaturas existentes?
nameNome do planoNão
amountValor em ReaisNão - apenas novas
billingIntervalIntervalo de cobrançaNão - apenas novas
trialDaysDias de testeNão - apenas novas
isActiveDisponibilidadeNão
Alterações de amount e trialDays afetam apenas novas assinaturas. Assinaturas existentes mantêm os valores originais contratados.

​
Resposta de Sucesso (200 OK)

{
  "id": "price_def456uvw",
  "productId": "prod_abc123xyz",
  "sellerId": 1,
  "name": "Plano Mensal Premium",
  "amount": 59.90,
  "currency": "BRL",
  "billingInterval": "monthly",
  "trialDays": 7,
  "isActive": true,
  "createdAt": "2024-01-15T10:35:00.000Z",
  "updatedAt": "2024-01-20T15:00:00.000Z"
}

​
Desativar um Plano

Para impedir novas assinaturas em um plano sem excluí-lo: 
curl -X PATCH https://garu.com.br/api/subscription-prices/456 \
  -H "Authorization: Bearer sk_test_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{"isActive": false}'
Desativar um plano não afeta assinaturas existentes. Elas continuam sendo cobradas normalmente.

​
Erros Comuns

{
  "statusCode": 404,
  "message": "Subscription price not found"
}
Solução: Verifique se o ID do preço está correto.
{
  "statusCode": 400,
  "message": ["amount must be a positive number"]
}
Solução: O valor deve ser um número positivo em Reais.

​
Próximos Passos

Excluir Preço

Remova um preço

Listar Assinaturas

Consulte assinaturas ativas