Coleções de Produtos

​

Principais Destaques

• Estrutura baseada em coleções: Agrupe produtos relacionados (planos, níveis, opções de preços) em uma única coleção para um gerenciamento organizado.
• Uma coleção, vários produtos: Inclua múltiplos produtos como Starter, Pro, Lifetime etc., cada um com seu próprio modelo de preços.
• Experiência de checkout dinâmica: Exiba todos os produtos de uma coleção em uma única visualização de checkout, permitindo que os clientes escolham o plano preferido.
• Controle a nível de comerciante: Ative, desative e reorganize produtos dentro de cada coleção. O primeiro produto é automaticamente pré-selecionado no checkout.
• Consciência do ciclo de vida: Permita que os clientes façam upgrade ou downgrade entre produtos da mesma coleção pelo Portal do Cliente.

​

Criando uma Coleção de Produtos

1

Create the collection

Defina a coleção com um nome e descrição opcional. Faça upload de uma imagem para representar visualmente a coleção no checkout.

Campos da coleção:

• Nome (obrigatório): Nome exibido para a coleção (por exemplo, “Planos SaaS”, “Níveis de Licença”)
• Descrição (opcional): Breve explicação exibida no checkout
• Imagem (opcional): Identidade visual para a coleção

2

Add products to the collection

Adicione produtos existentes à sua coleção. Os produtos podem ser organizados em grupos para uma estrutura mais clara.

Organização dos produtos:

• Grupos: Organize opcionalmente os produtos em grupos nomeados (por exemplo, “Planos Mensais”, “Planos Anuais”)
• Produtos sem grupo: Produtos sem grupo aparecem no nível da coleção
• Ordenação: Arraste e solte para definir a ordem de exibição

Cada produto pode pertencer a apenas uma coleção. Se um produto já estiver em outra coleção, será necessário removê-lo primeiro.

3

Configure ordering and visibility

Controle a ordem de exibição e a visibilidade dos produtos dentro da coleção.Opções de configuração:

• Status do produto: Ative ou desative produtos individuais dentro da coleção
• Ordem de exibição: Arraste e solte para definir a sequência em que os produtos aparecem no checkout

O primeiro produto da coleção é automaticamente pré-selecionado como padrão no checkout. Reordene os produtos para alterar qual deles é selecionado por padrão.

​

Checkout da Coleção

​

Tipos de Checkout

​

Experiência de Checkout da Coleção

1. Todos os produtos ativos exibidos: Os clientes veem cada produto habilitado na coleção
2. Primeiro produto pré-selecionado: O primeiro produto na ordem da coleção é automaticamente selecionado
3. Detalhes do produto exibidos: Cada produto mostra seu nome, descrição e preço
4. Seleção única: O cliente seleciona um único produto para comprar
5. Fluxo padrão continua: Após a seleção, o checkout prossegue com os preços e configurações de cobrança do produto escolhido

​

Integração com API

const session = await client.checkoutSessions.create({
  product_collection_id: 'pdc_abc123',
  product_cart: [], // Required: pass an empty array for collection checkout
  return_url: 'https://yoursite.com/return'
});

// Redirect customer to the checkout
window.location.href = session.url;

​

Integração com o Portal do Cliente

​

Ações de Gerenciamento de Plano

​

Regras de Upgrade/Downgrade

• Upgrades e downgrades estão disponíveis apenas entre produtos dentro da mesma coleção
• A prorrogação é aplicada com base nas configurações de assinatura
• Notificações por e-mail são enviadas ao negócio em cada upgrade, downgrade ou cancelamento

​

Configurações de Assinatura

​

Configurações Disponíveis

​

Gerenciando Coleções

​

Operações no Painel

• Criar: Configure novas coleções com produtos e grupos
• Atualizar: Modifique nome, descrição, imagem e organização dos produtos
• Reordenar: Arraste e solte para alterar a ordem de exibição dos produtos
• Ativar/Desativar produtos: Controle quais produtos aparecem no checkout
• Excluir: Remova uma coleção (os produtos permanecem, mas ficam desvinculados)

​

Melhores Práticas

• Agrupe logicamente: Organize produtos por intervalo de cobrança (mensal/anual) ou nível de recursos (starter/pro/enterprise)
• Ordene estrategicamente: Coloque o plano mais popular ou recomendado primeiro, pois ele será pré-selecionado no checkout
• Use nomes claros: Os nomes dos produtos devem comunicar claramente as diferenças de valor
• Habilite as duas direções: Permita upgrades e downgrades para dar flexibilidade aos clientes
• Considere a prorrateação: Escolha um modo de prorrateio alinhado ao modelo de negócio
• Faça testes completos: Verifique os fluxos de checkout e de mudança de plano em modo de teste antes de publicar