Cobranca de Plugins
A cobranca de plugin e tratada de ponta a ponta pela Levy atraves do Stripe Connect. Operadores veem uma unica cobranca em seu cartao; a Levy divide automaticamente a receita entre o fornecedor e a Levy, ficando com uma taxa de plataforma de 20%.
Modelos de preco
Cada plugin declara um de quatro modelos de preco em seu manifesto:
| Modelo | Quando voce e cobrado | Exemplo |
|---|---|---|
| Gratuito | Nunca | Slack, Zapier, Teste de tempo de reacao |
| Unico | Uma vez, na instalacao | Taxas de configuracao para plugins de autosservico |
| Mensal | Todo mes, proporcional no primeiro ciclo | Captur.ai (US$ 99/mes), SparkPark (US$ 49/mes), exportacao BigQuery (US$ 199/mes) |
| Uso | Mensal em atraso, baseado em eventos | Veriff (por verificacao), Persona (por verificacao) |
O badge de preco no cartao do marketplace sempre mostra o preco inicial. A pagina de detalhes mostra a divisao completa de precos.
A taxa de plataforma de 20%
Para cada plugin pago, a Levy cobra uma taxa de plataforma de 20% sobre o valor bruto cobrado. Os 80% restantes sao pagos ao fornecedor via Stripe Connect.
Exemplo: assinatura mensal Captur.ai a US$ 99/mes.
| Item | Valor |
|---|---|
| Cartao do operador cobrado | US$ 99,00 |
| Taxa de processamento Stripe | -US$ 3,10 |
| Taxa de plataforma Levy (20% bruto) | US$ 19,80 |
| Repasse ao fornecedor (Captur.ai) | US$ 76,10 |
A taxa de plataforma e configuravel por acordo de fornecedor - parceiros estrategicos podem negociar ate 10%, fornecedores de nicho podem pagar ate 30%. A taxa e fixa pela vida util de uma instalacao quando voce se inscreve.
Configuracao do Stripe Connect
A Levy usa Stripe Connect (a mesma infraestrutura que paga frotas parceiras pela receita de corridas). Para operadores, isto e invisivel - voce ve uma cobranca rotulada como "Levy Plugins" em seu extrato de cartao, e a divisao acontece nos bastidores.
Para fornecedores, veja Portal do desenvolvedor - fornecedores completam o onboarding Stripe Connect Express uma vez e a Levy automaticamente direciona sua parte de cada fatura de plugin.
Faturas
Cada cobranca gera um registro plugin_invoice:
| Campo | Descricao |
|---|---|
amount_cents | Total cobrado do operador |
platform_fee_cents | Parte de 20% da Levy |
vendor_amount_cents | Parte de 80% do fornecedor |
period_start / period_end | Periodo de cobranca (para mensal/uso) |
status | pending, paid, failed ou refunded |
As faturas sao visiveis em Painel -> Configuracoes -> Cobranca -> Faturas de plugin, baixaveis como PDF.
Cobranca por uso
Plugins cobrados por uso (Veriff, Persona) postam registros de uso de volta para a Levy via API de plugin conforme os eventos acontecem. No final do mes, a Levy:
- Agrega registros de uso nao faturados do mes anterior.
- Calcula o valor total =
unit_amount * units. - Aplica a taxa de plataforma de 20%.
- Cria uma fatura Stripe Connect com o fornecedor como destino.
- Cobra seu cartao no proximo ciclo de faturamento.
O reconciliador de cobranca mensal roda como cron Vercel as 02:00 UTC no dia 1 de cada mes. Se uma cobranca falhar (cartao recusado), a fatura entra no status failed e enviaremos um e-mail e tentaremos novamente no cronograma padrao do Stripe.
Reconciliacao idempotente
O reconciliador verifica se uma fatura ja existe para o mesmo periodo antes de criar uma nova, entao reexecutar o cron nunca cobra em duplicata.
Reembolsos
Se um plugin funcionar mal e voce precisar de reembolso:
- Contate o fornecedor primeiro atraves de sua support_url (listado na pagina de detalhes do plugin). Ele emite o reembolso atraves do Stripe Connect - tanto a parte do fornecedor quanto a taxa de plataforma da Levy sao retornadas.
- Se o fornecedor nao responder apos 5 dias uteis, contate o suporte Levy e mediaremos.
O fornecedor - nao a Levy - tem a decisao do reembolso porque o fornecedor controla o servico sendo reembolsado.
Disputas
Se voce abrir um chargeback atraves do seu banco, o Stripe Connect lida com a disputa em nome da Levy. A Levy coleta evidencias tanto dela mesma (log de auditoria, historico de entrega de webhook) quanto do fornecedor. A taxa de plataforma e retornada junto com a parte do fornecedor se a disputa for perdida.
Pagamentos falhados
Se seu cartao for recusado em uma cobranca mensal ou de uso:
- A fatura entra no status
failed. - O Stripe tenta novamente em seu cronograma padrao (4 tentativas ao longo de ~2 semanas).
- Seu plugin permanece ativo durante a janela de tentativas.
- Se todas as tentativas falharem, o plugin e desativado mas nao desinstalado - sua configuracao e preservada. Atualize seu metodo de pagamento em Configuracoes -> Cobranca e tentaremos a cobranca novamente.
Limites do nivel gratuito
Subcontas no plano gratuito da Levy podem instalar ate dois plugins gratuitos. Plugins pagos sao bloqueados no plano gratuito; atualize para instala-los. Planos pagos nao tem limite de contagem de plugins.
O que vem a seguir
- Configurando um plugin - alterar configuracoes, rotacionar tokens
- Portal do desenvolvedor - configurar Stripe Connect como fornecedor
- FAQ - perguntas comuns sobre cobranca