API
Tiers
Configurar tiers de assinatura — preços, trial, anual e benefícios.
Tiers
Tiers são os níveis de assinatura de uma tribo. Cada tier tem preço, período de cobrança e benefícios próprios. Tiers criam preços correspondentes na Stripe automaticamente.
Endpoints
| Método | Endpoint | Descrição |
|---|---|---|
GET | /api/v1/tiers | Listar tiers (filtra por tribo) |
POST | /api/v1/tiers | Criar novo tier |
GET | /api/v1/tiers/:id | Buscar tier por ID |
PATCH | /api/v1/tiers/:id | Atualizar tier |
DELETE | /api/v1/tiers/:id | Desativar tier |
Criar tier
curl -X POST https://app.octalife.ai/api/v1/tiers \
-H "Authorization: Bearer ol_live_sua_chave" \
-H "Content-Type: application/json" \
-d '{
"community_id": "uuid",
"name": "Premium",
"price_cents": 9900,
"billing_period": "monthly",
"trial_days": 7,
"benefits": ["Lives mensais", "Grupo VIP", "Treinos exclusivos"]
}'Campos
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
community_id | uuid | Sim | ID da tribo |
name | string | Sim | Nome do tier (ex: "Básico", "Premium") |
price_cents | integer | Sim | Preço em centavos (ex: 9900 = R$ 99) |
billing_period | enum | Sim | monthly, quarterly, yearly |
trial_days | integer | Não (0) | Dias de trial gratuito |
benefits | string[] | Não | Lista de benefícios visíveis pro membro |
is_active | boolean | Não (true) | Se está aceitando assinaturas |
Listar tiers de uma tribo
curl -X GET 'https://app.octalife.ai/api/v1/tiers?community_id=uuid' \
-H "Authorization: Bearer ol_live_sua_chave"Resposta:
{
"success": true,
"data": [
{
"id": "uuid",
"community_id": "uuid",
"name": "Premium",
"price_cents": 9900,
"billing_period": "monthly",
"stripe_price_id": "price_xxxxx",
"trial_days": 7,
"active_subscribers": 105,
"is_active": true
}
]
}Atualizar preço
Mudar preço de um tier ativo cria um novo stripe_price_id. Membros existentes mantêm o preço antigo até renovação manual.
curl -X PATCH https://app.octalife.ai/api/v1/tiers/uuid \
-H "Authorization: Bearer ol_live_sua_chave" \
-H "Content-Type: application/json" \
-d '{ "price_cents": 11900 }'