Pular para o conteúdo principal
Na plataforma Supergasbras, o conceito de sessão é central para o processo de compra. Existem dois tipos de sessão: a sessão de carrinho (Cart) e a sessão de compra (Checkout). Cada uma tem responsabilidades distintas e juntas formam o fluxo completo de um pedido.

​
Sessão de carrinho

A sessão de carrinho é gerenciada pela Cart API e representa o estado do carrinho de um cliente antes de iniciar o processo de compra formal. Ela armazena os itens selecionados e permite:
  • Criar ou atualizar o carrinho de compras
  • Consultar o estado atual do carrinho
  • Agendar a sessão para uma data e horário específicos
Cada sessão de carrinho é identificada por um sessionId único que você define ao criar a sessão.

​
Sessão de compra

A sessão de compra é gerenciada pela Checkout API e representa o processo de finalização de um pedido. Ela encapsula:
  • Dados do cliente e endereço de entrega
  • Cupons promocionais aplicados
  • Método e status de pagamento
  • Estado geral do pedido (aberto, concluído, cancelado)

​
Ciclo de vida de uma sessão de compra

​
Relacionamento entre as sessões

Uma sessão de compra referencia uma sessão de carrinho. O fluxo típico é:
  1. Crie uma sessão de carrinho via Cart API
  2. Use o cartSessionId ao criar a sessão de compra na Checkout API
  3. Continue o checkout na Checkout API até a conclusão
O sessionId é um identificador que você controla. Use um UUID ou outro identificador único por cliente/sessão para evitar colisões.