API de validação de cupom

Como a validação de cupom funciona

Integre a API de validação de cupom a sistemas como sites de compras e sistemas de ponto de venda (POS). Para validar cupons, forneça até 1.000 códigos de cupom inseridos manualmente na propriedade de solicitação couponsToValidate.

Se o carrinho já contiver códigos de cupom em seus campos de cupom, a API também descobrirá e validará esses códigos. Você não precisa copiar esses códigos para couponsToValidate. Para cupons que passam nas verificações no nível do cupom, a API avalia a elegibilidade da promoção com base no local em que cada código é anexado.

• Para um cupom anexado ao cabeçalho do carrinho, a API avalia todo o carrinho.
• Para um cupom anexado a uma linha de carrinho, a API avalia apenas essa linha. A linha deve participar de uma promoção associada ao cupom.

Forneça o carrinho e seus itens de linha na solicitação, usando a mesma estrutura do carrinho que a API Promoções elegíveis e a API de avaliação e execução da promoção.

Resultados de validação de cupom

Para cada código de cupom, a resposta fornece estes detalhes.

• Um status agregado nos escopos aplicáveis. O status é Valid quando o cupom é aprovado para pelo menos um escopo aplicável. Caso contrário, o status é Invalid.
• Para um cupom válido, o escopo válido, o ID da promoção associado e, para um escopo de Line, os IDs do item de linha do carrinho aplicável.
• Para um cupom inválido, o motivo pela qual a validação falhou.