API atual/Referência completa/Lives de vendas

Voucher relâmpago

Entrega o código do voucher relâmpago da live ao cliente que assistiu o tempo mínimo, depois que o organizador o revelou.

O voucher relâmpago é um cupom escondido que o organizador libera no meio da live. Ele passa por duas travas: o organizador precisa revelar o voucher, e o cliente precisa ter assistido o tempo mínimo (flash_unlock_after_seconds, 900 segundos, ou 15 minutos, no padrão). Só quando as duas valem, esta rota devolve o código, que o cliente digita no carrinho.

POST/api/v1/storefront/live-sessions/{id}/flash-voucher/claimCliente

Resgatar o voucher relâmpago

Parâmetros de caminho

iduuidobrigatório

Id da live.

A rota não tem corpo.

Exemplo de requisição

bash

curl -X POST "$BASE_URL/api/v1/storefront/live-sessions/$SESSION_ID/flash-voucher/claim" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Código liberado

json

{ "code": "LIVE-RELAMPAGO-10" }

Campos da resposta

codestring

Código do voucher para aplicar no carrinho.

Erros

Status	Quando	Corpo
401	Sem token de cliente.	`{"error":"authentication required"}`
403	O organizador ainda não revelou o voucher, ou a live não tem voucher relâmpago.	`{"error":"flash_unavailable"}`
403	O cliente ainda não assistiu o tempo mínimo.	`{"error":"not_unlocked"}`
403	Módulo `live-commerce` desligado.	`{"error":"module_disabled","module":"live-commerce"}`
404	A gamificação não está disponível.	`{"error":"gamification not available"}`

Veja também