API
Assinaturas
Listar e gerenciar assinaturas ativas, trials e cancelamentos.
Assinaturas
Assinaturas são vínculos ativos entre membros e tiers. São criadas automaticamente quando um membro paga via Stripe Checkout.
Endpoints
| Método | Endpoint | Descrição |
|---|---|---|
GET | /api/v1/subscriptions | Listar assinaturas |
GET | /api/v1/subscriptions/:id | Buscar assinatura |
POST | /api/v1/subscriptions/:id/cancel | Cancelar assinatura |
POST | /api/v1/subscriptions/:id/refund | Reembolsar último pagamento |
Listar assinaturas
curl -X GET 'https://app.octalife.ai/api/v1/subscriptions?community_id=uuid&status=active' \
-H "Authorization: Bearer ol_live_sua_chave"Query params
| Param | Descrição |
|---|---|
community_id | Filtrar por tribo |
tier_id | Filtrar por tier |
status | trialing, active, past_due, canceled |
member_id | Filtrar por membro |
page, limit | Paginação |
Resposta:
{
"success": true,
"data": [
{
"id": "uuid",
"community_id": "uuid",
"tier_id": "uuid",
"member_id": "uuid",
"status": "active",
"current_period_start": "2026-04-01T00:00:00Z",
"current_period_end": "2026-05-01T00:00:00Z",
"cancel_at_period_end": false,
"created_at": "2026-02-01T15:30:00Z",
"stripe_subscription_id": "sub_xxxxx"
}
]
}Cancelar assinatura
Por padrão, cancela no fim do ciclo atual (membro mantém acesso até a renovação).
curl -X POST https://app.octalife.ai/api/v1/subscriptions/uuid/cancel \
-H "Authorization: Bearer ol_live_sua_chave" \
-H "Content-Type: application/json" \
-d '{ "immediate": false, "reason": "Member request" }'| Campo | Tipo | Descrição |
|---|---|---|
immediate | boolean | true cancela na hora (sem reembolso pro-rata) |
reason | string | Anotação interna (não enviada ao membro) |