intermediate
juicer
pagamentos
stripe-connect

Pagamentos de Juicer

Como pagamentos funcionam no Levy Swap - Stripe Connect Express, taxas, cron de pagamento, holds e reversoes, processo 1099

Levy Fleets TeamMay 18, 20266 min read

Pagamentos de Juicer

Quando um Juicer completa drop limpo, plataforma enfileira pagamento. Pagamentos saem via Stripe Connect Express em 24 a 48 horas.

A Linha de Pagamento

Cada sessao gera exatamente uma juicer_payouts com:

  • session_id
  • juicer_id
  • amount_cents - liquido
  • platform_fee_cents - Levy (padrao 15%, configuravel por subconta)
  • stripe_transfer_id - quando transferencia tem sucesso
  • status - queued, paid, on_hold, reversed, canceled
  • scheduled_for - menor horario para drenar
  • created_at

Como a Taxa e Calculada

ComponenteCentavosExemplo ($5 base, 1,5x surge)
Brutogross$7,50
Taxa15%$1,13
Liquidogross - fee$6,37

Toggle separado controla se taxa vem do Juicer (padrao) ou do operador.

O Cron de Pagamento

juicer-payouts roda a cada 15 minutos. Ele:

  1. Le queued com scheduled_for <= now()
  2. Chama Stripe transfers.create com idempotency_key = juicer_payout_<id>
  3. Sucesso -> paid + stripe_transfer_id
  4. Falha -> permanece queued, retry

scheduled_for padrao = 24h apos sessao. Operador pode reduzir.

Quando Sao Segurados

on_hold em vez de queued quando:

  • Sessao tem fraud flags
  • Juicer com lifetime_fraud_score &gt;= 25
  • Operador com auto_hold_payouts = true
  • Hold manual

Esperam decisao. Do dashboard:

  • Liberar -> queued com novo scheduled_for
  • Cancelar -> nunca pago
  • Reverter (so paid) -> reversal Stripe

Reversals 5-7 dias uteis; se Juicer gastou, Levy carrega perda.

O Que Juicers Veem

Em Earnings:

  • Total vitalicio
  • Pagamentos pagos
  • 30 dias
  • Por sessao bruto, taxa, liquido
  • IDs Stripe

Hold ou reversal: "Em revisao" com contato do operador.

Visao do Operador

Dashboard -> Swap -> Pagamentos e o livro:

ColunaSignificado
DataConclusao
JuicerNome + email
SessaoTrilha completa
BrutoAntes da taxa
TaxaLevy
LiquidoJuicer
Estadoqueued / paid / on_hold / reversed / canceled
TransferLink Stripe

CSV export para contabilidade.

1099 / Fim de Ano

Stripe Connect Express gera 1099-NEC anual. Nome legal e SSN da Stripe Identity devem combinar.

Contabilidade do operador concilia:

  • Custo de bounty - bruto total (CSV)
  • Taxa - Levy (CSV)
  • Liquido - transferencias Stripe

Reembolsos e Disputas

Disputas seguem hold -> revisao -> liberar/reverter:

  1. Operador marca sessao
  2. Vai para on_hold (ou permanece paid para revisao)
  3. Operador revisa fotos, GPS, carga
  4. Valido -> liberar
  5. Invalido -> reverter + fraud + ban opcional

Sem fluxo de disputa iniciado pelo Juicer hoje - contato direto com operador. Reversal e final.

Problemas Comuns

  • Pagamento preso em queued - Stripe Connect nao habilitado totalmente
  • "insufficient balance" - float Levy baixo; cron retry
  • Juicer "nao recebi" mas paid - banco leva 1-3 dias uteis
  • Reversal falhou - sem saldo no Juicer; Levy carrega ate proximo offset