PayZu GatewayRecorrência

Reativar uma assinatura


Nesta páginaReative a assinaturaO que muda na assinaturaConfirme a reativaçãoErros desta operação

Leve de volta a active a assinatura cancelada de um cliente que voltou, sem criar outra assinatura.

Reative a assinatura

bash
curl -X POST https://api.sandbox.payzu.dev/v1/subscriptions/sub_EG9uphTcCTMvYBkHPKr4cc/reactivate \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

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 assinaturaDepois da reativação
statusactive
cancellation, grace e billing.canceled_atnull
billing.renewal_failures0
previous_cancellationsRecebe no início o cancelamento desfeito, com a data da reativação em reactivated_at.
Última fatura, se está canceled e ainda não venceuVolta a pending, com cancellation e billing.canceled_at nulos, sem evento de fatura.
billing.next_at no PixContinua o mesmo se ainda está no futuro. Se já passou, vai para a próxima data do ciclo.
billing.next_at no cartãoPassa 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ódigoHTTPMensagem
-404Assinatura não encontrada para o id informado.
-404Cliente não encontrado para o id informado.
PZ034404Recorrência não ativada para esta conta.
PZ510409Só uma assinatura cancelada pode ser reativada.
PZ511409O prazo de 30 dias para reativar esta assinatura terminou.
PZ512409Esta assinatura foi cancelada por estorno ou contestação do pagamento. Crie uma nova assinatura.
PZ513409Esta assinatura não chegou a ser ativada. Crie uma nova assinatura.
PZ514503Nã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.