Assinaturas

Assinaturas unem cliente, plano e método de pagamento em um ciclo recorrente operável.

Rotas públicas

• POST /v1/subscriptions
• GET /v1/subscriptions
• GET /v1/subscriptions/{id}
• PATCH /v1/subscriptions/{id}
• POST /v1/subscriptions/{id}/pause
• POST /v1/subscriptions/{id}/resume
• POST /v1/subscriptions/{id}/cancel
• POST /v1/subscriptions/{id}/reactivate
• POST /v1/subscriptions/{id}/change-plan
• POST /v1/subscriptions/{id}/update-card

Recomendações

• Guarde subscription_id, período atual e próxima cobrança.
• Não use webhook apenas para e-mail; ele é parte do fechamento financeiro.
• Separe cancelamento imediato de cancelamento ao fim do período no seu domínio.