Publicar no marketplace e entender o checkout

O marketplace público consulta os produtos públicos da empresa, incluindo os recebidos de parceiros por afiliações Ativas ou Em andamento.

Publicar uma oferta

1. Abra Produtos → Gerenciar → Editar produto.
2. Confira descrição, imagem, preço e links.
3. Ative Produto público.
4. Conclua com Avançar → Pronto.
5. Abra a página pública da empresa e confira a oferta.

A rota pública do frontend é /public/marketplaces/slug-da-empresa. A empresa precisa estar configurada para que sua página seja encontrada. Veja também o guia geral de Marketplace.

Para retirar o item, desative Produto público e salve. Um produto afiliado privado no cadastro original também fica fora da consulta pública do parceiro.

O que o visitante faz

O visitante pode filtrar tipos, abrir os detalhes e ajustar quantidade. Se checkoutEnabled estiver habilitado na empresa, a página mostra opções para Adicionar, Comprar agora e Ir para o checkout. Se estiver desabilitado, pode oferecer o acesso à Landing Page, quando cadastrada.

O carrinho guarda identificadores e quantidades no armazenamento local do navegador, por marketplace. Ele aceita combinar vários itens e usa o preço do catálogo para calcular o resumo.

Etapas do checkout atual

1. Identificação: nome, e-mail, documento e telefone.
2. Endereço: solicitado se houver ao menos um Bem de Consumo no conjunto. Para os demais tipos, a interface pula essa etapa.
3. Pagamento: escolha de método e aceite obrigatório.
4. Finalização:
   • a tela envia POST /public/checkout;
   • a API cria o cliente, um pedido por vendedor e a cobrança no ATLA Pay (Asaas, via milie), numa só transação;
   • a tela mostra o QR Pix ou o link da fatura e consulta o status a cada 5 segundos.

A implementação trata consumableGood como físico, para a etapa de endereço. Produtos do tipo digital (curso, mentoria, canal de materiais) exigem conta: sem login, a compra é recusada com DIGITAL_REQUIRES_ACCOUNT, e a tela convida a entrar ou criar conta.

Revisão de 08/11/2026

A finalização grava os pedidos e gera a cobrança de verdade. O acesso digital é liberado quando o pagamento é confirmado (Order/on-paid.js). Na versão de 08/10, a confirmação era só local.

• Só produtos próprios: o checkout aceita somente produtos próprios e públicos do vendedor. Um item afiliado aparece na vitrine, mas é recusado com PRODUCT_NOT_AVAILABLE.
• Preço: é sempre o do cadastro, recalculado na API.

Relação com outros controles

Controle	Atua nesse checkout?
Produto público	Sim, define o catálogo público consultado.
Checkout habilitado na empresa	Sim, habilita a entrada nessa jornada.
Tipo físico/digital	Sim, determina a etapa de endereço.
Preço e quantidade	Sim; o preço é recalculado na API a partir do cadastro.
Lotes / fila de aquisição das áreas	Não há conexão encontrada nesse fluxo.
Link afiliado / comissão	Produto afiliado não é comprável pelo checkout (PRODUCT_NOT_AVAILABLE); a comissão de afiliação não tem repasse. A comissão da ATLA (split da subconta) é configurada na empresa.
Tipo Assinatura	Não configura cobrança recorrente nessa finalização.

Para vendas efetivamente registradas, consulte Vendas e CRM.