Primeiros passos com as APIs Supergasbras

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
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.

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:

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:

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

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:

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

Criar um pedido completo

Guia detalhado do fluxo completo de compra, do carrinho ao pagamento.

Aplicar cupons

Saiba como listar, reservar e aplicar cupons promocionais.

Processar pagamentos

Detalhes sobre os métodos de pagamento e como iniciar uma cobrança.

API Reference

Referência completa de todos os endpoints disponíveis.

​Pré-requisitos

​Passo 1: Criar ou atualizar o carrinho

​Passo 2: Consultar o carrinho

​Passo 3: Criar a sessão de checkout

​Passo 4: Atualizar informações de entrega

​Passo 5: Consultar métodos de pagamento

​Próximos passos