Encerrar

Desfazer cancelamento agendado

Desfaz um cancelamento agendado para o fim do período. A assinatura continua normalmente e as cobranças seguem nas datas previstas.

DELETE/v1/subscriptions/:subscriptionId/scheduled-cancellation

Base URL Produção:https://api.validapay.com.br

Base URL Sandbox:https://sandbox.validapay.com.br

Só funciona antes da data do cancelamento. Assinatura já cancelada não volta por esta rota.

Authorizations

bearer

Authorization

string obrigatório

Cabeçalho de autenticação Bearer no formato Bearer {{token}} onde {{token}} é o seu token OAuth2.

Escopos requeridos

subscriptions/write

Path Parameters

subscriptionIdstringobrigatório

ID da assinatura (ex: sub_xxx) - required

← Anterior

Cancelar assinatura

Listar Notas Fiscais

const url = 'https://sandbox.validapay.com.br/v1/subscriptions/:subscriptionId/scheduled-cancellation';

const options = {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer {{token}}'
  },
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response Examples

200▾

JSON

{
    "success": true, 
    "subscriptionId": "sub_xxx", 
    "cancelAtPeriodEnd": false 
}

Campos da resposta

successboolean

true quando o agendamento foi desfeito

subscriptionIdstring

ID da assinatura

cancelAtPeriodEndboolean

false: não há mais cancelamento agendado

400sem agendamento▾

JSON

{
    "error": {
        "message": "Assinatura não possui cancelamento agendado",
        "code": "CANCEL_NOT_SCHEDULED",
        "details": null,
        "timestamp": "2026-09-24T12:00:00.000Z"
    }
}

← Anterior

Cancelar assinatura

Listar Notas Fiscais