Stripe Connect — Gestao de Contas
Overview
O iaw-platform e o orchestrator central de Stripe Connect. Cada cliente que vende servicos precisa de uma conta Connect para receber pagamentos.
Estados de uma conta
| Estado | Significado | Accao |
|---|---|---|
pending_onboarding | Cliente ainda nao preencheu KYC | Aguardar |
pending_verification | Stripe a verificar dados | Aguardar (ate 48h) |
active | Pagamentos e payouts activos | Nenhuma |
restricted | Stripe detectou problema | Cliente deve actualizar dados |
Pagina Admin Stripe
Aceder em Admin > Stripe. Mostra:
- KPIs: subscricoes activas, receita total, contas Connect, clientes Stripe
- Tabela de contas Connect: filtro por estado, detalhes por conta
- Accoes: re-sync (forcar verificacao), eliminar conta
Endpoints Admin
Nota: Os KPIs do dashboard (subscricoes, receita, etc.) vem de
GET /api/admin/stripe. Os endpoints abaixo sao especificos da gestao de contas Connect.
| Metodo | Path | Descricao |
|---|---|---|
| GET | /api/stripe-connect/admin/accounts | Listar contas |
| GET | /api/stripe-connect/admin/accounts/{id} | Detalhe de uma conta |
| POST | /api/stripe-connect/admin/retry/{client_id} | Re-sync estado |
| DELETE | /api/stripe-connect/admin/accounts/{account_id} | Eliminar conta |
Troubleshooting
- Conta restricted: o cliente precisa de actualizar dados KYC (NIF, IBAN, morada)
- Conta pending_verification: aguardar ate 48h — Stripe verifica automaticamente
- Webhook nao processado: verificar logs em
/api/stripe-connect/webhook