GuiasOperadorAtualizado em
Conectar sua loja
De onde vêm as vendas: conectores prontos, sistema personalizado e o que cada selo quer dizer.
As comissões nascem de vendas. Conectores é onde você diz de onde elas vêm: sua loja, seu checkout ou seu meio de pagamento.

Dois caminhos
- Um conector pronto: escolha o card do sistema que você já usa e clique em Conectar. A tela mostra a URL de ingestão que você cola no painel dele.
- Sistema personalizado: qualquer sistema que saiba enviar um webhook JSON. Você recebe a URL e aponta, campo a campo, onde estão o valor, o cliente e o identificador da venda.
Quem prefere integrar direto pelo próprio código continua com a API: veja Integrar a venda.
O que os selos querem dizer
Cada card lista o que aquele conector consegue mandar:
| Selo | O que significa |
|---|---|
| estorno | avisa quando a venda é estornada, e a comissão é revertida |
| estorno parcial | avisa devolução parcial |
| assinatura | manda as cobranças seguintes, não só a primeira |
| cliente estável | manda sempre o mesmo identificador de cliente, o que permite reconhecer renovação |
| cupom | manda o cupom usado, o que permite atribuir a venda pelo cupom do parceiro |
| modo teste | dá pra mandar uma venda de teste antes de valer |
Selo que não aparece é capacidade que aquele sistema não entrega. Sem estorno, por exemplo, uma devolução não reverte a comissão sozinha: você estorna a venda à mão em Vendas.
"Não homologado"
Os conectores externos trazem esse aviso: o mapeamento foi escrito a partir da documentação de cada sistema, mas ainda não foi validado com credencial real. Faça uma venda de teste antes de confiar e confira em Vendas se ela chegou com valor, cliente e parceiro certos. O aviso some conforme cada conector é homologado.
Se der errado
- Instalei e a venda não aparece em Vendas: confira a URL de ingestão no painel do outro sistema e faça uma venda de teste. Se continuar sem chegar, fale com o suporte: a ingestão é ligada por ambiente e pode ainda não estar ativa no seu.
- Chegou sem parceiro: faltou o cupom ou o clique no link do parceiro. Veja a atribuição em Integrar a venda pela API.
- Valor errado: no sistema personalizado, o mapeamento aponta o campo errado. Reabra o conector e ajuste.