PUT
/
subscriptions
/
{subscriptionId}
cURL
curl --request PUT \
  --url https://sandbox-api.superpagamentos.com/subscriptions/{subscriptionId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "tokenizedCardId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "frequency": 123,
  "title": "<string>",
  "amount": 123,
  "duration": 123,
  "expirationDate": "2026-06-06"
}'
{
  "data": {
    "id": "b84f592c-7db6-44fa-b783-4a327156880b",
    "customerId": "536feaf7-014b-4ad3-a2db-f14897bc2275",
    "tokenizedCardId": "10aaa074-dd95-4bdb-9618-f81e6fdc1e17",
    "title": "Teste atualização de título do plano",
    "amount": 3990,
    "setupAmount": 1000,
    "frequency": 15,
    "duration": 12,
    "dueDate": "2025-06-04",
    "expirationDate": "2026-06-06",
    "tolerancePeriod": 5,
    "status": "ACTIVE",
    "splits": [
      {
        "id": "768cbcdb-82b7-4aee-8900-2d9e89a9f3fc",
        "subaccountId": "c873d310-d2eb-41da-adaa-36fc8900fb99",
        "splitType": "PERCENTAGE",
        "splitPercentage": 80,
        "splitAmount": null,
        "liquidAmount": 2392,
        "chargebackLiable": true
      },
      {
        "id": "4e3e376d-bea9-403d-be3e-5ea36fc60099",
        "subaccountId": "beff457d-e893-49df-8395-e8b67ab21e7c",
        "splitType": "AMOUNT",
        "splitPercentage": null,
        "splitAmount": 500,
        "liquidAmount": 500,
        "chargebackLiable": false
      }
    ],
    "createdAt": "2025-06-05T02:54:58.146Z",
    "updatedAt": "2025-06-06T02:11:28.818Z",
    "canceledAt": null
  },
  "message": "Assinatura atualizada com sucesso"
}

Authorizations

​
Authorization
string
header
required

Token JWT gerado na rota de autenticação (/auth). Deve ser enviado no formato: Bearer <token>

Path Parameters

​
subscriptionId
string<uuid>
required

Identificador único da assinatura

Body

application/json

Dados que podem ser atualizados na assinatura

​
customerId
string<uuid>

ID do cliente associado à assinatura

​
tokenizedCardId
string<uuid>

ID do cartão tokenizado para cobrança

​
frequency
integer

Frequência em dias que será cobrado (ex: 7 para semanal, 30 para mensal)

​
title
string

Título/descrição da assinatura

​
amount
integer

Valor da assinatura em centavos

​
duration
integer

Duração em ciclos (quantas vezes será cobrado). Opcional, se não informado será vitalício

​
expirationDate
string<date>

Data de expiração da assinatura. Precisa estar no formato YYYY-MM-DD

Example:

"2026-06-06"

Response

Assinatura atualizada com sucesso

​
data
object
​
message
string
Example:

"Assinatura atualizada com sucesso"