Aplicar cupons promocionais no checkout 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:

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:

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:

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:

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:

curl -X DELETE "https://checkout-ms.supergasbras.app/v1/sessions/a1b2c3d4-e5f6-7890-abcd-ef1234567890/coupons/DESCONTO10" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI"

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.

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

​Listar cupons disponíveis do cliente

​Reservar um cupom para o cliente

​Aplicar cupom à sessão de compra

​Listar cupons aplicados na sessão

​Remover um cupom da sessão

​Erros comuns

Listar cupons disponíveis do cliente

Reservar um cupom para o cliente

Aplicar cupom à sessão de compra

Listar cupons aplicados na sessão

Remover um cupom da sessão

Erros comuns