> ## Documentation Index
> Fetch the complete documentation index at: https://pedirgasdocs.supergasbras.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Primeiros passos com as APIs Supergasbras

> Aprenda a criar uma sessão de carrinho, iniciar o checkout, configurar a entrega e consultar métodos de pagamento nas APIs Supergasbras em menos de 10 minutos.

Este guia mostra como fazer sua primeira integração completa com as APIs Supergasbras. Você vai criar uma sessão de carrinho, iniciar o checkout e consultar os métodos de pagamento disponíveis.

## Pré-requisitos

* Um token de acesso válido — veja [Autenticação](/authentication)
* Uma ferramenta para fazer requisições HTTP (cURL, Postman, ou o cliente de sua preferência)

## Passo 1: Criar ou atualizar o carrinho

Use a Cart API para criar uma sessão de carrinho. Substitua `SESSION_ID` por um identificador único para a sessão do cliente.

```bash theme={null}
curl -X PUT "https://cart-ms.supergasbras.app/v1/sessions/f47ac10b-58cc-4372-a567-0e02b2c3d479" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "c9b1d2e3-f4a5-6789-bcde-f01234567890"
  }'
```

A API retorna os dados da sessão de carrinho criada ou atualizada.

## Passo 2: Consultar o carrinho

Confirme que o carrinho foi criado corretamente:

```bash theme={null}
curl -X GET "https://cart-ms.supergasbras.app/v1/sessions/f47ac10b-58cc-4372-a567-0e02b2c3d479" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI"
```

## Passo 3: Criar a sessão de checkout

Com o carrinho pronto, inicie o checkout na Checkout API:

```bash theme={null}
curl -X POST "https://checkout-ms.supergasbras.app/v1/sessions" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "cartSessionId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "customerId": "c9b1d2e3-f4a5-6789-bcde-f01234567890"
  }'
```

Guarde o `sessionId` retornado — você vai usá-lo nos próximos passos.

## Passo 4: Atualizar informações de entrega

```bash theme={null}
curl -X PUT "https://checkout-ms.supergasbras.app/v1/sessions/a1b2c3d4-e5f6-7890-abcd-ef1234567890/delivery" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "address": {
      "street": "Rua Exemplo",
      "number": "123",
      "city": "São Paulo",
      "state": "SP",
      "zipCode": "01310-100"
    }
  }'
```

## Passo 5: Consultar métodos de pagamento

Liste os métodos de pagamento disponíveis para a sessão:

```bash theme={null}
curl -X GET "https://checkout-ms.supergasbras.app/v1/sessions/a1b2c3d4-e5f6-7890-abcd-ef1234567890/payments/methods" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI"
```

## Próximos passos

<CardGroup cols={2}>
  <Card title="Criar um pedido completo" icon="receipt" href="/guides/create-order">
    Guia detalhado do fluxo completo de compra, do carrinho ao pagamento.
  </Card>

  <Card title="Aplicar cupons" icon="tag" href="/guides/apply-coupon">
    Saiba como listar, reservar e aplicar cupons promocionais.
  </Card>

  <Card title="Processar pagamentos" icon="credit-card" href="/guides/payment">
    Detalhes sobre os métodos de pagamento e como iniciar uma cobrança.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/cart/overview">
    Referência completa de todos os endpoints disponíveis.
  </Card>
</CardGroup>