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

# Aplicar cupons promocionais no checkout Supergasbras

> Saiba como listar cupons disponíveis, reservar e aplicar códigos de desconto em sessões de compra ativas usando a Checkout API da Supergasbras.

A Checkout API da Supergasbras permite que você liste, reserve e aplique cupons promocionais durante o processo de compra. Este guia explica como gerenciar cupons em uma sessão de checkout.

## Listar cupons disponíveis do cliente

Antes de aplicar um cupom, você pode consultar os cupons disponíveis para um cliente:

```bash theme={null}
curl -X GET "https://checkout-ms.supergasbras.app/v1/customers/c9b1d2e3-f4a5-6789-bcde-f01234567890/coupons" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI"
```

## Reservar um cupom para o cliente

Para garantir que um cupom seja reservado para uso exclusivo do cliente:

```bash theme={null}
curl -X POST "https://checkout-ms.supergasbras.app/v1/customers/c9b1d2e3-f4a5-6789-bcde-f01234567890/coupons" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "DESCONTO10"
  }'
```

## Aplicar cupom à sessão de compra

Com uma sessão de checkout ativa, aplique o código promocional:

```bash theme={null}
curl -X PUT "https://checkout-ms.supergasbras.app/v1/sessions/a1b2c3d4-e5f6-7890-abcd-ef1234567890/coupons" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "DESCONTO10"
  }'
```

## Listar cupons aplicados na sessão

Verifique quais cupons estão ativos na sessão de compra:

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

## Remover um cupom da sessão

Para remover um cupom aplicado à sessão:

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

<Warning>
  Um cupom removido da sessão pode não estar disponível para uso imediato novamente dependendo das regras do sistema de promoções. Confirme com a equipe Supergasbras.
</Warning>

## Erros comuns

| Cenário                    | Solução                                                         |
| -------------------------- | --------------------------------------------------------------- |
| Cupom inválido ou expirado | Verifique o código e a validade do cupom                        |
| Cupom já aplicado          | Não é possível aplicar o mesmo cupom duas vezes na mesma sessão |
| Sessão inexistente         | Confirme que o `sessionId` está correto                         |