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 Team18 de maio de 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