Endpoint: PATCH /subscriptions/seller/{seller_id}/plans/{plans_pk}/subscribers/{id}/
Autenticação: JWT Bearer ou chave de API do vendedor — porém o método não é suportado nesta rota.
Este endpoint não está habilitado. Requisições PATCH e PUT para esta URL retornam sempre 405 Method Not Allowed. A única transição de estado disponível através da API autenticada é o cancelamento, descrito abaixo.

Cancelamento

Para cancelar a assinatura de um assinante, envie um POST para a ação cancel no mesmo recurso:
POST /subscriptions/seller/{seller_id}/plans/{plans_pk}/subscribers/{id}/cancel/
Comportamento:
  • Define o status do assinante como canceled e registra canceled_at = agora.
  • Atualiza em lote todos os pagamentos da assinatura desse assinante que estavam com payment_status='pending' para payment_status='canceled'.
  • Dispara a notificação de confirmação de cancelamento.
  • Retorna 200 com o assinante atualizado, ou 400 se o assinante já estiver cancelado.
O próprio assinante também pode cancelar pelo endpoint público POST /subscriptions/subscriber/{subscriber_id}/cancel/, que executa o mesmo fluxo.

Criação de assinantes

A criação de assinantes ocorre exclusivamente pelo fluxo público de adesão. Consulte Assinar plano (público) para criar um novo assinante e iniciar a cobrança da assinatura.

Outras atualizações

Os campos de identidade do assinante (nome, e-mail, telefone, documento) são definidos no momento da criação, pelo fluxo público de adesão, e não podem ser alterados por esta API. Os campos next_billing_date, last_payment_date e status são derivados da atividade de pagamentos e são atualizados automaticamente sempre que um pagamento da assinatura transita para paid, failed ou overdue.

Erros

StatusQuando
405PATCH ou PUT contra esta URL — sempre retornado.
400Na ação cancel, quando o assinante já está cancelado.
404O assinante não existe ou não pertence a este plano.