Comissões & repasses
Como a comissão é calculada, como ela "amadurece" (refund-hold) e como você registra o pagamento ao afiliado. A plataforma calcula e registra, mas não movimenta dinheiro — o repasse é feito por você.
Status da venda
Toda venda atribuída aparece como pendente nos primeiros 15 dias após o pagamento e vira aprovada depois disso — uma janela de segurança contra estornos. Reembolso ou chargeback marcam a venda como estornada. É o status exibido na lista de vendas, tanto para o anunciante quanto para o afiliado.
Cálculo
| Tipo | Fórmula |
|---|---|
| Percentual | valor pago × percentual (ex.: 20% de R$ 49,00 = R$ 9,80) |
| Fixo | um valor fixo por venda, independente do ticket |
A base é o valor efetivamente pago no evento. Comissão ≤ 0 não gera lançamento.
Recorrência
| Modo | Comissiona |
|---|---|
first_only | só a 1ª cobrança |
first_n | as primeiras N cobranças |
lifetime | toda cobrança, enquanto a assinatura viver (padrão) |
O ciclo é contado pelas conversões da mesma assinatura. Em assinaturas Stripe, a 1ª cobrança apenas semeia a atribuição; a comissão vem em cada invoice.paid — sem dobrar na primeira.
Ciclo de vida no ledger
- Retida (em hold). Nasce retida, com uma data de liberação = data da venda + janela de refund-hold.
- Liberada. Passada a janela, entra no valor "a repassar" automaticamente — sem nenhuma ação sua.
- Paga. Quando você registra o repasse, o lançamento vira pago.
Refund-hold
A janela de segurança antes de liberar (configurável por programa):
| Método | Padrão |
|---|---|
| Cartão (e boleto) | 120 dias |
| Pix | 7 dias |
Clawback (estorno)
Reembolso ou chargeback geram um lançamento negativo que abate o valor a repassar, referenciando a conversão original. Assim você não paga por venda que voltou.
Resumo do afiliado
Os painéis somam o ledger em três números:
| Campo | É |
|---|---|
| Pendente | comissão ainda dentro do refund-hold |
| Liberado | fora do hold e ainda não pago (já abatidos os clawbacks) |
| Pago | repasses já registrados |
Repasses
Você (anunciante) paga o afiliado por fora (Pix/transferência) e registra o pagamento. O afiliado é notificado por e-mail.
| Endpoint | O que faz |
|---|---|
GET /api/v1/payouts/owed | quanto você deve a cada afiliado: total e a parcela já fora do hold |
POST /api/v1/payouts/mark-paid | registra o repasse: marca as comissões liberadas como pagas e cria o registro |