.sw-reveal,.sw-reveal[data-reveal=rise]>*,.sw-scene .sw-bar,.sw-scene .sw-spark-area,.sw-scene .sw-spark-dot{opacity:1!important;transform:none!important;filter:none!important}.sw-scene .sw-spark-line{stroke-dashoffset:0!important}html:has(main>[data-theme=dark]:first-child) .sw-header[data-boot]{background:#0e0f11}

Entrar Criar conta grátis

Receber

Proteger e dividir

Entregar e medir

Por modelo de negócio

Sem site ou em rede

Gerente de conta exclusivo

Toda empresa tem um gerente de conta, para um suporte individual e humanizado.

Conhecer o gerente de conta

Construir

Operar

Para quem vende

Para quem comprou

Ouvidoria

Não resolveu no atendimento? A Ouvidoria revê o caso, com protocolo.

Abrir na Ouvidoria

Valida um cupom contra um carrinho (prévia do desconto)

POST/v1/coupons/validate

Autentique com o header SelectKey: a chave sk_test_ opera no sandbox, a sk_live_ em produção. Como autenticar.

Corpo da requisição

codestringobrigatório
O código do cupom.
amountintegerobrigatório
Valor do carrinho em centavos, antes do desconto.
itemIdsstring[]
Ids das variantes no carrinho — para cupons restritos a itens específicos.
itemCountinteger
Número de itens no carrinho.
customerIdstring
O comprador — para cupons limitados a um uso por cliente ou a clientes específicos.

Respostas

200Sucesso

codestringobrigatório
O código do cupom.
validbooleanobrigatório
Se o cupom vale para este carrinho.
reasonstringobrigatóriopode ser nulo
Por que não vale; null quando válido.
discountobjectobrigatóriopode ser nulo
O desconto que o cupom aplicaria; null quando não é válido.
+3 campos de discount
- typestringobrigatório
  percentage ou flat.
  Valores:percentageflat
- valueintegerobrigatório
  O desconto, em centavos.
- percentagenumberobrigatório
  O desconto como percentual do valor do carrinho.
chargedAmountintegerobrigatóriopode ser nulo
Valor do carrinho depois do desconto (centavos).
originalAmountintegerobrigatóriopode ser nulo
Valor do carrinho antes do desconto (centavos).

400Requisição inválida (validação)

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

401Não autenticado (credencial ausente ou inválida)

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

403Sem permissão

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

500Erro interno do servidor

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

AnteriorCria um cupom PróximaConsulta um cupom

Requisição

curl -X POST "https://api.selectwin.io/v1/coupons/validate" \
  -H "SelectKey: $SELECTWIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "string",
  "amount": 5000,
  "itemIds": [
    "id_0a1b2c3d4e5f60718293"
  ],
  "itemCount": 0,
  "customerId": "cus_0a1b2c3d4e5f60718293"
}'

Resposta

{
  "code": "string",
  "valid": true,
  "reason": "string",
  "discount": {
    "type": "percentage",
    "value": 5000,
    "percentage": 0
  },
  "chargedAmount": 5000,
  "originalAmount": 5000
}