API
Saques (Payouts)
Histórico de saques Stripe Connect e saldo disponível.
Saques (Payouts)
Saques são transferências da sua conta Stripe Connect pra sua conta bancária. O OctaLife abstrai a Stripe, mas a fonte de verdade é a Stripe API.
Todos os pagamentos são processados via Stripe Connect. Você fica com 90% — a taxa OctaLife (10%) é deduzida automaticamente.
Endpoints
| Método | Endpoint | Descrição |
|---|---|---|
GET | /api/v1/payouts | Listar saques |
GET | /api/v1/payouts/balance | Saldo atual (disponível e pendente) |
POST | /api/v1/payouts/manual | Solicitar saque manual |
GET | /api/v1/payouts/:id | Buscar saque |
Saldo atual
curl -X GET https://app.octalife.ai/api/v1/payouts/balance \
-H "Authorization: Bearer ol_live_sua_chave"Resposta:
{
"success": true,
"data": {
"currency": "BRL",
"available_cents": 3240000,
"pending_cents": 850000,
"this_month_received_cents": 12400000,
"all_time_cents": 145800000,
"next_auto_payout_at": "2026-04-22T00:00:00Z",
"payout_schedule": "weekly"
}
}Solicitar saque manual
curl -X POST https://app.octalife.ai/api/v1/payouts/manual \
-H "Authorization: Bearer ol_live_sua_chave" \
-H "Content-Type: application/json" \
-d '{ "amount_cents": 1000000 }'Disponível só se sua conta Stripe está em modo manual. Para mudar pra automatic, ajuste no painel.
Listar saques
curl -X GET 'https://app.octalife.ai/api/v1/payouts?status=paid&limit=10' \
-H "Authorization: Bearer ol_live_sua_chave"| Status | Descrição |
|---|---|
pending | Aguardando processamento Stripe |
in_transit | Enviado pro banco |
paid | Recebido na conta bancária |
failed | Falhou (saldo retorna a available) |