Reativar uma assinatura
Leve de volta a active a assinatura cancelada de um cliente que voltou, sem criar outra assinatura.
Reative a assinatura
curl -X POST https://api.sandbox.payzu.dev/v1/subscriptions/sub_EG9uphTcCTMvYBkHPKr4cc/reactivate \
-H "Authorization: Bearer SUA_CHAVE_DE_API"{
"id": "sub_EG9uphTcCTMvYBkHPKr4cc",
"code": "EELBD9PE",
"status": "active",
"updated_at": "2026-11-25T10:05:44.310Z",
"billing": {
"anchor_at": "2026-11-11T03:00:00.000Z",
"next_at": "2026-12-11T15:20:59.362Z",
"canceled_at": null,
"renewal_failures": 0
},
"grace": null,
"cancellation": null,
"previous_cancellations": [
{
"canceled_at": "2026-11-20T14:02:11.438Z",
"reason": "merchant_request",
"note": "Cliente pediu o cancelamento",
"reactivated_at": "2026-11-25T10:05:44.310Z"
}
]
}Referência: Reativar uma assinatura
A rota não tem corpo e vale para a assinatura canceled que cumpre estas condições:
- foi cancelada há até 30 dias;
- já teve uma fatura paga, mesmo que estornada depois;
- não foi cancelada por estorno nem por contestação;
- não tem fatura contestada.
O prazo de 30 dias conta a partir de billing.canceled_at.
Depois dele, a PayZu recusa a reativação. Para cobrar o cliente de novo, crie outra assinatura.
O que muda na assinatura
| Na assinatura | Depois da reativação |
|---|---|
status | active |
cancellation, grace e billing.canceled_at | null |
billing.renewal_failures | 0 |
previous_cancellations | Recebe no início o cancelamento desfeito, com a data da reativação em reactivated_at. |
Última fatura, se está canceled e ainda não venceu | Volta a pending, com cancellation e billing.canceled_at nulos, sem evento de fatura. |
billing.next_at no Pix | Continua o mesmo se ainda está no futuro. Se já passou, vai para a próxima data do ciclo. |
billing.next_at no cartão | Passa a ser a próxima cobrança informada pela adquirente. |
- Pix: a PayZu não cobra o período em que a assinatura ficou cancelada.
- Cartão: a recorrência volta a valer na adquirente. Se a adquirente não reativar, ou se outra alteração da mesma assinatura estiver em curso, a assinatura segue cancelada: repita a chamada depois de um intervalo.
- Cliente excluído: a reativação da assinatura de um cliente excluído responde
404.
Confirme a reativação
A resposta 200 traz a assinatura inteira, e sai subscription.reactivated, com o corpo de Assinatura reativada.
A assinatura também volta a active sem esta rota quando o pagamento de uma fatura é confirmado depois do cancelamento por adesão vencida ou por ciclo do Pix vencido. Nesses casos, sai o mesmo evento, como explica Ciclo da assinatura. Para conferir sem o webhook, consulte a assinatura.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
| - | 404 | Assinatura não encontrada para o id informado. |
| - | 404 | Cliente não encontrado para o id informado. |
PZ034 | 404 | Recorrência não ativada para esta conta. |
PZ510 | 409 | Só uma assinatura cancelada pode ser reativada. |
PZ511 | 409 | O prazo de 30 dias para reativar esta assinatura terminou. |
PZ512 | 409 | Esta assinatura foi cancelada por estorno ou contestação do pagamento. Crie uma nova assinatura. |
PZ513 | 409 | Esta assinatura não chegou a ser ativada. Crie uma nova assinatura. |
PZ514 | 503 | Não foi possível reativar a assinatura agora. Tente de novo. |
Os erros de autenticação, de idempotência e de validação estão no Catálogo de erros.