Buscar cupom por código — código promocional / voucher de desconto
Retorna o melhor lote de cupom para o carrinho atual com base na política de resgate ativa. O serviço:
- Lista os lotes disponíveis para a política da loja.
- Calcula o desconto que cada lote geraria (valor
fixedou percentual sobretotal_item). - Escolhe o "high-pass" (menor desconto que ainda cobre
redeemableTotal). Se nenhum lote cobrir, cai para o "low-pass" (maior desconto abaixo deredeemableTotal).
Use o couponBatchId retornado em Reservar cupom para travar um código para
a transação. Campos monetários (total_item, redeemableTotal) são enviados como
inteiros em centavos — veja Valores monetários.
Try-it values populated from environment ACME (Demo)
Autenticação
Token
Send your user token in the x-guper-authorization header. Endpoints that
support a Public mode (e.g. acúmulo and resgate previews) accept the same
request without the header — Private mode adds customer data and a
confirmation token to the response.
Cabeçalhos
Corpo da requisição
Content-Type:
application/json