Documentação da API
Autenticação
Subcontas
Contas Bancárias
Clientes
Tokenização de Cartões
Assinaturas de Recorrência
Saldo e Transferências
Antecipações de Recebíveis
Webhooks
Assinaturas de Recorrência
Atualizar assinatura
Atualiza os dados de uma assinatura existente. Esta rota permite atualizar diversos campos da assinatura, exceto os dados de split. Para alterar os dados de split, é necessário utilizar a rota específica para isso.
PUT
/
subscriptions
/
{subscriptionId}
Copy
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"
}'
Copy
{
"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
Token JWT gerado na rota de autenticação (/auth). Deve ser enviado no formato: Bearer <token>
Path Parameters
Identificador único da assinatura
Body
application/json
Dados que podem ser atualizados na assinatura
The body is of type object
.
Response
200
application/json
Assinatura atualizada com sucesso
The response is of type object
.
Copy
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"
}'
Copy
{
"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"
}
Assistant
Responses are generated using AI and may contain mistakes.